Drive With Compliments from your own code

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

{"task": "leave-cards", "headline": "...", "pinches": [{"name": "...", "verdict": "rogue", "card": "...", "why": "...", "mend": "..."}], "closing": "..."}

{
 "task": "leave-cards",
 "pinches": "1. The last biscuit | what happened: not given | whose it was: A housemate | how much they would miss it: Barely | how you will make it good: Replace it | was it the last one: Yes\n2. Borrowed phone charger | what happened: it is still plugged in by my bed | whose it was: A housemate | how much they would miss it: A little | how you will make it good: Nothing yet | was it the last one: No\n3. The good blanket | what happened: it has been on my sofa for a while | whose it was: A housemate | how much they would miss it: A lot | how you will make it good: Give it back | was it the last one: No",
 "facts": "1. The last biscuit: honour 4 of 5; verdict gentleman; weakest article: Never take the last one; card opens: Dear housemate; mend: nothing to mend\n2. Borrowed phone charger: honour 2 of 5; verdict rogue; weakest article: Make it good; card opens: Dear housemate; mend: change the plan from Nothing yet to Replace it or Give it back (whichever fits the thing), landing in gentleman\n3. The good blanket: honour 3 of 5; verdict rogue; weakest article: Take only a trifle; card opens: Dear housemate; mend: the plan is already Give it back; no change of plan lifts it, so it stays rogue\ncounts: return-it 0, gentleman 1, rogue 2 (of 3 pinches)\nfinest pinch: The last biscuit"
}

{
 "task": "leave-cards",
 "headline": "Three pinches earn one gentleman thief card and two charming rogue cards.",
 "pinches": [
  {
   "name": "The last biscuit",
   "verdict": "gentleman",
   "card": "Dear housemate, I'll own up to taking the last biscuit, with a wink for my cheek. I will replace it to make it right.",
   "why": "The article \"Never take the last one\" cost you points, since you answered yes to taking the last one. Still, you only called it barely missed and you mean to replace it, so the card comes from a gentleman thief.",
   "mend": "You don't need another step here, since your card already sets this right."
  },
  {
   "name": "Borrowed phone charger",
   "verdict": "rogue",
   "card": "Dear housemate, I'll come clean, I borrowed your phone charger and it is still plugged in by my bed. I don't have a plan yet, so tell me what would put this right.",
   "why": "The article \"Make it good\" cost you points, since your plan was nothing yet. You still said the housemate would miss it only a little, keeping you a charming rogue.",
   "mend": "Since the charger is still by your bed, you could give it back to make this right."
  },
  {
   "name": "The good blanket",
   "verdict": "rogue",
   "card": "Dear housemate, I confess, your good blanket has been on my sofa for a while. With a playful grin, I will give it back to you.",
   "why": "The article \"Take only a trifle\" cost you points, since you said the housemate would miss it a lot. You also said you will give it back, keeping you a charming rogue rather than needing to return it.",
   "mend": "Your plan to give it back already does what it can, so the rest is simply owning up in the card."
  }
 ],
 "closing": "The last biscuit is the finest pinch here, ahead of the others."
}

{
 "task": "leave-cards",
 "pinches": "1. Stapler from the next desk | what happened: it has quietly moved onto my desk | whose it was: A colleague | how much they would miss it: Barely | how you will make it good: Give it back | was it the last one: No\n2. Oat milk in the office fridge | what happened: I used the last of it in my tea | whose it was: Everyone (it was shared) | how much they would miss it: A little | how you will make it good: Make it up another way | was it the last one: No\n3. Coins from the tea fund | what happened: I took them for the vending machine | whose it was: Everyone (it was shared) | how much they would miss it: Barely | how you will make it good: Replace it | was it the last one: No",
 "facts": "1. Stapler from the next desk: honour 5 of 5; verdict gentleman; weakest article: none; card opens: Dear colleague; mend: nothing to mend\n2. Oat milk in the office fridge: honour 3 of 5; verdict rogue; weakest article: Take only a trifle; card opens: Dear all; mend: change the plan from Make it up another way to Replace it or Give it back (whichever fits the thing), landing in gentleman\n3. Coins from the tea fund: honour 5 of 5; verdict return-it (off-limits: money, valuables, documents, medicine, a shop or a stranger); weakest article: none; card opens: Dear all; mend: hand it back or replace it - it is off-limits, so no plan makes it a pinch\ncounts: return-it 1, gentleman 1, rogue 1 (of 3 pinches)\nfinest pinch: Stapler from the next desk"
}

{
 "task": "leave-cards",
 "headline": "Cards leave the tray: one thing goes back, one plays the gentleman thief, one confesses like a charming rogue.",
 "pinches": [
  {
   "name": "Stapler from the next desk",
   "verdict": "gentleman",
   "card": "Dear colleague, I confess I took your stapler, which has quietly moved onto my desk, and with a small bow, I will give it back.",
   "why": "The whole code holds together here: the colleague would barely miss it, and you plan to give it back.",
   "mend": "Here, the card itself is enough, so there is nothing more for you to do."
  },
  {
   "name": "Oat milk in the office fridge",
   "verdict": "rogue",
   "card": "Dear all, I admit I used the last of the oat milk in my tea, and with a small tip of my hat, I promise to make it up to you.",
   "why": "The weakest article, \"take only a trifle,\" cost points because everyone would miss the oat milk a little, even though you plan to make it up another way.",
   "mend": "Because the oat milk is used up, you could simply replace it instead of making it up another way."
  },
  {
   "name": "Coins from the tea fund",
   "verdict": "return-it",
   "card": "Dear all, I took coins from the tea fund for the vending machine, and I am sorry. The replacement goes with this card.",
   "why": "Coins are money, so the code never covers them, even though everyone would barely miss them and you plan to replace it.",
   "mend": "Since the coins went into the vending machine, the plain step for you is to replace them in the tea fund."
  }
 ],
 "closing": "Stapler from the next desk is the finest pinch on the tray."
}

{
 "task": "leave-cards",
 "pinches": "1. The green hoodie | what happened: I wore it home after the visit | whose it was: A family member | how much they would miss it: A little | how you will make it good: Give it back | was it the last one: No\n2. The TV remote | what happened: it has been in my bag since I left | whose it was: A family member | how much they would miss it: A lot | how you will make it good: Nothing yet | was it the last one: No\n3. The last slice of cake | what happened: not given | whose it was: A friend | how much they would miss it: A lot | how you will make it good: Replace it | was it the last one: Yes\n4. Two clues of the crossword | what happened: I filled them in while it was left on the table | whose it was: A friend | how much they would miss it: Barely | how you will make it good: Make it up another way | was it the last one: No",
 "facts": "1. The green hoodie: honour 4 of 5; verdict gentleman; weakest article: Take only a trifle; card opens: Dear family; mend: nothing to mend\n2. The TV remote: honour 1 of 5; verdict return-it; weakest article: Take only a trifle; card opens: Dear family; mend: change the plan from Nothing yet to Replace it or Give it back (whichever fits the thing), landing in rogue\n3. The last slice of cake: honour 2 of 5; verdict rogue; weakest article: Take only a trifle; card opens: Dear friend; mend: the plan is already Replace it; no change of plan lifts it, so it stays rogue\n4. Two clues of the crossword: honour 4 of 5; verdict gentleman; weakest article: Make it good; card opens: Dear friend; mend: nothing to mend\ncounts: return-it 1, gentleman 2, rogue 1 (of 4 pinches)\nfinest pinch: The green hoodie"
}

{
 "task": "leave-cards",
 "headline": "Two cards here are gentleman thief, one is a charming rogue, and one thing has to go back.",
 "pinches": [
  {
   "name": "The green hoodie",
   "verdict": "gentleman",
   "card": "Dear family, I took the green hoodie and wore it home after the visit. With a small bow, I will give it back to you.",
   "why": "The \"take only a trifle\" article cost you points because your family would only miss the hoodie a little, but you answered give it back and no to it being the last one, which kept this a gentleman thief.",
   "mend": "Here, no further mend is needed, because the card you leave is enough to make this right."
  },
  {
   "name": "The TV remote",
   "verdict": "return-it",
   "card": "Dear family, I am sorry, I took the TV remote, and I am returning it to you.",
   "why": "The \"take only a trifle\" article cost you points because your family would miss the remote a lot, and answering nothing yet alongside that is why this has to go back.",
   "mend": "The remote is still around, so you can mend this by giving it back rather than leaving it unresolved."
  },
  {
   "name": "The last slice of cake",
   "verdict": "rogue",
   "card": "Dear friend, I confess, I took the last slice of cake. With a small bow, I will replace it for you.",
   "why": "The \"take only a trifle\" article cost you points because your friend would miss the cake a lot, and taking the last one too left little room, even though you answered replace it, so this stays a charming rogue.",
   "mend": "Your plan to replace it does what it can, so let the card own up to the rest."
  },
  {
   "name": "Two clues of the crossword",
   "verdict": "gentleman",
   "card": "Dear friend, I confess, I filled in two clues of the crossword while it was left on the table. With a tip of the hat, I will make it up to you.",
   "why": "The \"make it good\" article cost you points because you answered make it up another way, though your friend would barely miss the clues and it was not the last one, so this stays a gentleman thief.",
   "mend": "Nothing more needs mending here, because leaving the card sets things right for you."
  }
 ],
 "closing": "The green hoodie is the finest pinch on the tray, simply the one that stood highest on the list."
}

const K = PinchKit;
const form = K.form({ alias: "", pinches: [
  { name: "The last biscuit", note: "", owner: "housemate", missed: "barely", plan: "replace", last: "yes" },
  { name: "Borrowed umbrella", note: "it is still by my door", owner: "colleague", missed: "little", plan: "none", last: "no" }] });
const built = K.buildInput(form);       // built.facts holds each pinch's honour, verdict, weakest article and mend
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
// K.md(built, reply, K.title(form), K.signature(form))   // the tray as Markdown

BASE="https://api.skillsafe.ai/v1/app-api"
TOKEN="paste-your-token-here"   # from https://with-compliments.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":"with-compliments"}' | jq -r '.data.token')

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

# input.json: the run input object - {"task": "leave-cards", "pinches": "1. The last biscuit | what happened: ... | ...", "facts": "...", ...}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="with-compliments:leave-cards:$(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: with-compliments:leave-cards:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json