Drive Room in the Tank from your own code

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

{"task": "stock", "headline": "...", "fish": [{"id": "c1", "note": "..."}, ...], "new_fish": "...", "verdict": "no_room", "rehome": "c4", "rehome_note": "...", "smaller_yes": "...", "reply_line": "..."}

{
 "task": "stock",
 "willing_hours": "6",
 "commitments": "c1: choir rehearsal - 2 h a week - lifts you - flexible - 33% of your hours\nc2: the residents' committee - 3 h a week - drains you - flexible - 50% of your hours\nc3: helping at my sister's cafe - 2 h a week - leaves you even - fixed - 33% of your hours",
 "new_ask": "running the office quiz - 1.5 h a week - you guess it leaves you even - 25% of your hours",
 "asked_by": "a colleague",
 "facts": "willing: 6 h a week\nkept now: 7 h a week, 117% of your hours\nwith the new one: 8.5 h a week, 142% of your hours\ndraining hours with the new one: 3 of 8.5, 35%\nverdict: overstocked\nrehome: c2 (the residents' committee, 3 h a week) - frees 3 h - enough: yes\nsmaller_yes_hours: none"
}

{
 "task": "stock",
 "headline": "Your tank's already overflowing before running the office quiz even gets a look in.",
 "fish": [
  {
   "id": "c1",
   "note": "Choir rehearsal takes 2 hours a week, lifts you, and stays flexible."
  },
  {
   "id": "c2",
   "note": "The residents' committee drains you for 3 hours a week, though it stays flexible."
  },
  {
   "id": "c3",
   "note": "Helping at your sister's cafe takes 2 hours a week, leaves you even, and stays fixed."
  }
 ],
 "new_fish": "Running the office quiz would take 1.5 hours a week and you guess it would leave you even, bringing your week to 8.5 hours, 142% of your hours.",
 "verdict": "overstocked",
 "rehome": "c2",
 "rehome_note": "Freeing up the residents' committee's 3 hours a week would be enough on its own.",
 "smaller_yes": "",
 "reply_line": "I can't take on running the office quiz for now, since my week has no space left."
}

{
 "task": "stock",
 "willing_hours": "10",
 "commitments": "c1: book club - 1.5 h a week - lifts you - flexible - 15% of your hours\nc2: Spanish evening class - 2 h a week - leaves you even - fixed - 20% of your hours\nc3: walking a neighbour's dog - 1 h a week - lifts you - flexible - 10% of your hours\nc4: treasurer for the allotment society - 2 h a week - drains you - flexible - 20% of your hours",
 "new_ask": "coaching the under-10s football team - 4 h a week - you guess it leaves you even - 40% of your hours",
 "asked_by": "the club secretary",
 "facts": "willing: 10 h a week\nkept now: 6.5 h a week, 65% of your hours\nwith the new one: 10.5 h a week, 105% of your hours\ndraining hours with the new one: 2 of 10.5, 19%\nverdict: no_room\nrehome: c4 (treasurer for the allotment society, 2 h a week) - frees 2 h - enough: yes\nsmaller_yes_hours: 2"
}

{
 "task": "stock",
 "headline": "Coaching the under-10s football team wouldn't fit into your week as things stand.",
 "fish": [
  {
   "id": "c1",
   "note": "Book club lifts you for 1.5 hours a week and stays flexible."
  },
  {
   "id": "c2",
   "note": "Your Spanish evening class takes 2 hours a week, leaves you even, and is fixed."
  },
  {
   "id": "c3",
   "note": "Walking a neighbour's dog lifts you in 1 hour a week and keeps things flexible."
  },
  {
   "id": "c4",
   "note": "Treasurer for the allotment society drains you across 2 hours a week, though it's flexible."
  }
 ],
 "new_fish": "Coaching the under-10s football team would take 4 hours a week, and you guess it would leave you even, taking your week to 10.5 hours, 105% of your hours.",
 "verdict": "no_room",
 "rehome": "c4",
 "rehome_note": "Freeing up treasurer for the allotment society's 2 hours a week would be enough on its own.",
 "smaller_yes": "You could offer coaching the under-10s football team for 2 hours a week instead.",
 "reply_line": "I can take on coaching the under-10s football team for 2 hours a week."
}

{
 "task": "stock",
 "willing_hours": "12",
 "commitments": "c1: minutes secretary for the tenants' association - 2 h a week - drains you - flexible - 17% of your hours\nc2: refereeing league matches - 3 h a week - drains you - fixed - 25% of your hours\nc3: pottery class - 2 h a week - lifts you - flexible - 17% of your hours",
 "new_ask": "organising the street's bin rota - 2 h a week - you guess it drains you - 17% of your hours",
 "asked_by": "nobody named",
 "facts": "willing: 12 h a week\nkept now: 7 h a week, 58% of your hours\nwith the new one: 9 h a week, 75% of your hours\ndraining hours with the new one: 7 of 9, 78%\nverdict: murky\nrehome: c1 (minutes secretary for the tenants' association, 2 h a week) - frees 2 h - enough: no\nsmaller_yes_hours: none"
}

{
 "task": "stock",
 "headline": "Organising the street's bin rota would fit into your week, but too much of it would drain you.",
 "fish": [
  {
   "id": "c1",
   "note": "Minutes secretary for the tenants' association drains you over 2 hours a week, yet it's flexible."
  },
  {
   "id": "c2",
   "note": "Refereeing league matches drains you for 3 hours a week and stays fixed."
  },
  {
   "id": "c3",
   "note": "Pottery class lifts you for 2 hours a week and remains flexible."
  }
 ],
 "new_fish": "Organising the street's bin rota would take 2 hours a week, and you guess it would drain you, bringing your week to 9 hours, 75% of your hours.",
 "verdict": "murky",
 "rehome": "c1",
 "rehome_note": "Freeing up minutes secretary for the tenants' association's 2 hours a week wouldn't be enough on its own.",
 "smaller_yes": "",
 "reply_line": "I can't take on organising the street's bin rota as it stands, but could a less draining part of it work instead?"
}

{
 "task": "stock",
 "willing_hours": "9",
 "commitments": "c1: running club - 2 h a week - lifts you - flexible - 22% of your hours\nc2: helping my dad with his garden - 2 h a week - leaves you even - fixed - 22% of your hours\nc3: hosting board-game night - 2 h a week - lifts you - flexible - 22% of your hours",
 "new_ask": "volunteer reading helper at the library - 2 h a week - you guess it leaves you even - 22% of your hours",
 "asked_by": "the librarian",
 "facts": "willing: 9 h a week\nkept now: 6 h a week, 67% of your hours\nwith the new one: 8 h a week, 89% of your hours\ndraining hours with the new one: 0 of 8, 0%\nverdict: snug\nrehome: none\nsmaller_yes_hours: 1.5"
}

{
 "task": "stock",
 "headline": "Volunteer reading helper at the library would just fit, leaving barely any space in your tank.",
 "fish": [
  {
   "id": "c1",
   "note": "Running club lifts you for 2 hours a week and stays flexible."
  },
  {
   "id": "c2",
   "note": "Helping your dad with his garden takes 2 hours a week, leaves you even, and is fixed."
  },
  {
   "id": "c3",
   "note": "Hosting board-game night lifts you for 2 hours a week and remains flexible."
  }
 ],
 "new_fish": "Volunteer reading helper at the library would take 2 hours a week, and you guess it would leave you even, bringing your week to 8 hours, 89% of your hours.",
 "verdict": "snug",
 "rehome": "",
 "rehome_note": "",
 "smaller_yes": "You could offer to be the volunteer reading helper at the library for 1.5 hours a week instead.",
 "reply_line": "I can help as the volunteer reading helper at the library for 1.5 hours a week."
}

{
 "task": "stock",
 "willing_hours": "10",
 "commitments": "c1: choir - 2 h a week - lifts you - flexible - 20% of your hours\nc2: language exchange chat - 1 h a week - lifts you - flexible - 10% of your hours\nc3: the residents' newsletter - 1.5 h a week - leaves you even - flexible - 15% of your hours",
 "new_ask": "a beginners' running group - 1.5 h a week - you guess it lifts you - 15% of your hours",
 "asked_by": "my friend Sam",
 "facts": "willing: 10 h a week\nkept now: 4.5 h a week, 45% of your hours\nwith the new one: 6 h a week, 60% of your hours\ndraining hours with the new one: 0 of 6, 0%\nverdict: room\nrehome: none\nsmaller_yes_hours: none"
}

{
 "task": "stock",
 "headline": "A beginners' running group would fit into your week with plenty of space to spare.",
 "fish": [
  {
   "id": "c1",
   "note": "Choir lifts you for 2 hours a week and stays flexible."
  },
  {
   "id": "c2",
   "note": "Your language exchange chat lifts you in 1 hour a week and remains flexible."
  },
  {
   "id": "c3",
   "note": "The residents' newsletter takes 1.5 hours a week, leaves you even, and stays flexible."
  }
 ],
 "new_fish": "A beginners' running group would take 1.5 hours a week, and you guess it would lift you, bringing your week to 6 hours, 60% of your hours.",
 "verdict": "room",
 "rehome": "",
 "rehome_note": "",
 "smaller_yes": "",
 "reply_line": "I can take on a beginners' running group for 1.5 hours a week."
}

const K = TankKit;
const form = K.form({ willing: "10",
  ask: { name: "coaching the under-10s football team", hours: "4", feel: "even", who: "the club secretary" },
  items: [{ name: "book club", hours: "1.5", feel: "lifts" },
          { name: "treasurer for the allotment society", hours: "2", feel: "drains", fixed: false }] });
const built = K.buildInput(form);       // built.facts holds the sums, the verdict, the rehome pick and the smaller yes
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)                   // the whole tank as Markdown

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

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

# input.json: the run input object - {"task": "stock", "willing_hours": "10", "commitments": "...", "new_ask": "...", "asked_by": "the club secretary", "facts": "...", ...}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="room-in-the-tank:stock:$(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: room-in-the-tank:stock:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json