Drive Another Coal from your own code

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

{"task": "weigh-habits", "headline": "...", "habits": [{"name": "...", "verdict": "tight", "why": "...", "ripple": "...", "swap": "..."}], "closing": "..."}

{
 "task": "weigh-habits",
 "habits": "1. Thermostat kept low all evening | how it works: my flatmates pay their share of the bill too | who feels the pinch: People I live with | how much it pinches: Noticeably | did they agree to it: Never asked them | what it saves: A real amount\n2. Buying the thinnest loo roll | how it works: it is the cheapest pack in the shop | who feels the pinch: People I live with | how much it pinches: A little | did they agree to it: Never asked them | what it saves: Pennies\n3. Cancelling the film streaming plan | how it works: I was the only one who watched it | who feels the pinch: Just me | how much it pinches: Not at all | did they agree to it: does not apply | what it saves: A little\n4. Making my own lunch | how it works: not given | who feels the pinch: Just me | how much it pinches: A little | did they agree to it: does not apply | what it saves: A real amount\n5. Washing up in cold water | how it works: so the boiler stays off | who feels the pinch: People I live with | how much it pinches: Noticeably | did they agree to it: They have objected | what it saves: Pennies",
 "facts": "1. Thermostat kept low all evening: chill 3 of 5 (pinch on others 2, not agreed 1); verdict miserly\n2. Buying the thinnest loo roll: chill 2 of 5 (pinch on others 1, not agreed 1); verdict tight\n3. Cancelling the film streaming plan: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n4. Making my own lunch: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n5. Washing up in cold water: chill 4 of 5 (pinch on others 2, not agreed 2); verdict miserly\ncounts: miserly 2, tight 1, false-economy 0, fair-thrift 2 (of 5 habits)\nfirst move: Washing up in cold water"
}

{
 "task": "weigh-habits",
 "headline": "Of your five habits, two pinch others who did not agree, one is a bit tight, and two are fair thrift.",
 "habits": [
  {
   "name": "Thermostat kept low all evening",
   "verdict": "miserly",
   "why": "You keep the thermostat low all evening; your flatmates, who pay their share of the bill too, feel it noticeably and were never asked, for a real saving.",
   "ripple": "Your flatmates could feel less comfortable with the low heat, and the goodwill between you could wear thin.",
   "swap": "Ask your flatmates what thermostat setting they'd accept while still saving something on the bill."
  },
  {
   "name": "Buying the thinnest loo roll",
   "verdict": "tight",
   "why": "You buy the thinnest loo roll because it is the cheapest pack in the shop, which pinches the people you live with a little, without asking them, to save pennies.",
   "ripple": "The people you live with could find the thin loo roll a small irritation that nibbles away at their comfort and goodwill toward you.",
   "swap": "Ask the people you live with which loo roll thickness they would accept."
  },
  {
   "name": "Cancelling the film streaming plan",
   "verdict": "fair-thrift",
   "why": "You cancelled the film streaming plan since you were the only one who watched it, so there is no pinch on anyone, for a little saving.",
   "ripple": "Since you were the only one watching, this change could be one you settle into without missing anything.",
   "swap": ""
  },
  {
   "name": "Making my own lunch",
   "verdict": "fair-thrift",
   "why": "You make your own lunch, which pinches just you a little, for a real saving that costs nobody else anything.",
   "ripple": "A little pinch like this could stay easy for you to keep up, or could feel tiresome if it continues.",
   "swap": ""
  },
  {
   "name": "Washing up in cold water",
   "verdict": "miserly",
   "why": "You wash up in cold water so the boiler stays off, which pinches the people you live with noticeably, and they have objected, for a saving of pennies.",
   "ripple": "Since the people you live with have already objected, keeping this up could put further strain on the goodwill between you and on their comfort with it.",
   "swap": "Ask the people you live with what water temperature they would find acceptable instead."
  }
 ],
 "closing": "Look at Washing up in cold water first, before deciding on any of the other habits."
}

{
 "task": "weigh-habits",
 "habits": "1. Guests bring their own drinks | how it works: I say so on the invite | who feels the pinch: Guests or friends | how much it pinches: A little | did they agree to it: Yes, they agreed | what it saves: A real amount\n2. Splitting the dinner bill evenly | how it works: even when I ordered more than the others | who feels the pinch: Guests or friends | how much it pinches: Noticeably | did they agree to it: Never asked them | what it saves: A little\n3. Heating off until guests arrive | how it works: not given | who feels the pinch: Just me | how much it pinches: A little | did they agree to it: does not apply | what it saves: A little\n4. Party leftovers become my lunches | how it works: not given | who feels the pinch: Nobody notices | how much it pinches: Not at all | did they agree to it: does not apply | what it saves: A little\n5. Leaving no tip at group dinners | how it works: I leave the tip to the others | who feels the pinch: People who work for me or serve me | how much it pinches: Noticeably | did they agree to it: Never asked them | what it saves: Pennies",
 "facts": "1. Guests bring their own drinks: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n2. Splitting the dinner bill evenly: chill 3 of 5 (pinch on others 2, not agreed 1); verdict miserly\n3. Heating off until guests arrive: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n4. Party leftovers become my lunches: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n5. Leaving no tip at group dinners: chill 3 of 5 (pinch on others 2, not agreed 1); verdict miserly\ncounts: miserly 2, tight 0, false-economy 0, fair-thrift 3 (of 5 habits)\nfirst move: Splitting the dinner bill evenly"
}

{
 "task": "weigh-habits",
 "headline": "Two of five habits pass a cost to others who weren't asked; three cost nobody anything they haven't accepted.",
 "habits": [
  {
   "name": "Guests bring their own drinks",
   "verdict": "fair-thrift",
   "why": "You ask guests on the invite to bring their own drinks, and they agreed to it. It pinches them only a little, and it saves you a real amount.",
   "ripple": "Asking guests to bring their own drinks could make hosting feel a little less generous for them.",
   "swap": ""
  },
  {
   "name": "Splitting the dinner bill evenly",
   "verdict": "miserly",
   "why": "You split the dinner bill evenly even when you ordered more than the others, without asking them. It pinches your guests or friends noticeably, and it saves a little.",
   "ripple": "Splitting the bill evenly when you've ordered more could wear on the goodwill between you and your guests.",
   "swap": "Ask your guests what split they'd find fair, or cover the extra you ordered yourself."
  },
  {
   "name": "Heating off until guests arrive",
   "verdict": "fair-thrift",
   "why": "Turning the heating off until guests arrive only pinches you, and just a little, while it saves a little too.",
   "ripple": "Turning the heating off until guests arrive could mean a colder wait for you beforehand.",
   "swap": ""
  },
  {
   "name": "Party leftovers become my lunches",
   "verdict": "fair-thrift",
   "why": "Turning your party leftovers into lunches doesn't pinch anyone, since nobody even notices, and it saves a little.",
   "ripple": "Turning party leftovers into your lunches could make those lunches feel a little less varied for you.",
   "swap": ""
  },
  {
   "name": "Leaving no tip at group dinners",
   "verdict": "miserly",
   "why": "At group dinners you leave the tip to the others without asking them, and it pinches the people who work for you or serve you noticeably, for a saving of pennies.",
   "ripple": "Leaving the tip to others at group dinners could cost you goodwill with the people who work for you or serve you.",
   "swap": "Ask the others what they'd like to tip, or cover the tip yourself instead of leaving it to them."
  }
 ],
 "closing": "Start with splitting the dinner bill evenly, before weighing the other habits."
}

{
 "task": "weigh-habits",
 "habits": "1. Walking instead of taking the bus | how it works: about twenty minutes each way | who feels the pinch: Just me | how much it pinches: A little | did they agree to it: does not apply | what it saves: A little\n2. Reheating yesterday's coffee | how it works: not given | who feels the pinch: Just me | how much it pinches: Noticeably | did they agree to it: does not apply | what it saves: Pennies\n3. Cutting my own hair | how it works: with clippers I already own | who feels the pinch: Just me | how much it pinches: Noticeably | did they agree to it: does not apply | what it saves: A real amount\n4. Washing and reusing cling film | how it works: not given | who feels the pinch: Just me | how much it pinches: Noticeably | did they agree to it: does not apply | what it saves: Pennies\n5. Library books instead of buying | how it works: not given | who feels the pinch: Nobody notices | how much it pinches: Not at all | did they agree to it: does not apply | what it saves: A little",
 "facts": "1. Walking instead of taking the bus: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n2. Reheating yesterday's coffee: chill 0 of 5 (pinch on others 0, not agreed 0); verdict false-economy\n3. Cutting my own hair: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\n4. Washing and reusing cling film: chill 0 of 5 (pinch on others 0, not agreed 0); verdict false-economy\n5. Library books instead of buying: chill 0 of 5 (pinch on others 0, not agreed 0); verdict fair-thrift\ncounts: miserly 0, tight 0, false-economy 2, fair-thrift 3 (of 5 habits)\nfirst move: Reheating yesterday's coffee"
}

{
 "task": "weigh-habits",
 "headline": "Three of your five habits are fair thrift, two aren't worth the pinch, and none fall on someone who hasn't agreed.",
 "habits": [
  {
   "name": "Walking instead of taking the bus",
   "verdict": "fair-thrift",
   "why": "Walking instead of the bus takes about twenty minutes each way, and the pinch lands only on you, just a little, for a saving that's also a little.",
   "ripple": "The twenty minutes each way could start to feel long, which may affect whether you keep the habit up.",
   "swap": ""
  },
  {
   "name": "Reheating yesterday's coffee",
   "verdict": "false-economy",
   "why": "Reheating yesterday's coffee pinches you noticeably, for a saving that only comes to pennies.",
   "ripple": "Noticeably pinching yourself each time could chip away at your comfort, and may make the habit harder to keep up.",
   "swap": "Brew only what you will finish, to skip the reheating and its noticeable pinch."
  },
  {
   "name": "Cutting my own hair",
   "verdict": "fair-thrift",
   "why": "Cutting your own hair with clippers you already own pinches you noticeably, but it saves a real amount.",
   "ripple": "Doing it yourself each time could wear on your comfort with how it turns out, which may affect whether you keep cutting it yourself.",
   "swap": ""
  },
  {
   "name": "Washing and reusing cling film",
   "verdict": "false-economy",
   "why": "Washing and reusing cling film pinches you noticeably, for a saving that only comes to pennies.",
   "ripple": "Washing cling film each time could chip away at your patience, and may affect how long you keep doing it.",
   "swap": "Stop washing and reusing it, and use a fresh piece each time instead."
  },
  {
   "name": "Library books instead of buying",
   "verdict": "fair-thrift",
   "why": "Choosing library books over buying pinches nobody at all, while still saving you a little.",
   "ripple": "Sticking with library books instead of buying could affect how satisfied you feel with the habit, which may shape whether it continues.",
   "swap": ""
  }
 ],
 "closing": "Start with Reheating yesterday's coffee before looking at the rest of your habits."
}

const K = CoalKit;
const form = K.form({ habits: [
  { name: "Splitting the dinner bill evenly", note: "even when I ordered more", who: "guests", pinch: "real", asked: "never", size: "some" },
  { name: "Making my own lunch", note: "", who: "me", pinch: "mild", asked: "never", size: "real" }] });
const built = K.buildInput(form);       // built.facts holds each habit's chill, call and the first move
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))    // the check as Markdown

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

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

# input.json: the run input object - {"task": "weigh-habits", "habits": "1. Splitting the dinner bill evenly | how it works: ... | ...", "facts": "...", ...}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="another-coal:weigh-habits:$(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: another-coal:weigh-habits:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json