Drive Elbow Room from your own code

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

{"task": "fit", "verdict": "tweak", "headline": "...", "steps": [{"part": "chair", "do": "...", "why": "...", "using": "..."}, ...], "keep": "...", "strain": "...", "habit": "...", "closing": "..."}

{
 "task": "fit",
 "unit": "cm",
 "body": "height 175 cm; lower leg with shoes 46 cm (estimated from height); seat to elbow 25 cm (estimated from height); seat to eye 79 cm (estimated from height)",
 "setup": "A laptop on its own; chair height adjustable: no; desk height adjustable: no",
 "hours": "5",
 "strain": "neck, lower back",
 "on_hand": "a spare keyboard and mouse in a drawer, a few thick hardback books, a sofa cushion",
 "facts": "verdict: rework\nwhy: rule 1 - a laptop on its own is used for 2 hours or more a day\norder of fixes: chair, feet, screen, distance, laptop\nin range: keyboard\nchair: seat height now 46 cm, target 55 cm; change: raise by 9 cm - a firm cushion on the seat\nfeet: now no footrest, target a footrest 8 cm high; change: add a footrest 8 cm high - a footrest or a sturdy box\nkeyboard: keyboard surface height (on the desk) now 76 cm, target 76 cm; in range\nscreen: screen top edge now 100 cm, target 133 cm (eye level); change: raise by 33 cm - a laptop stand\ndistance: now 45 cm from the eyes, target 53 to 77 cm; change: move back by 8 cm to 53 cm - nothing extra, the screen itself slides\nlaptop: a laptop used on its own, so its screen and keys cannot both be at the right height; change: split them - a separate keyboard and mouse, with the laptop raised\nstrain: neck -> screen (to fix); lower back -> chair (to fix)\nbreaks: about 5 hours a day at this desk - a short break or change of activity of 5 to 10 minutes every hour"
}

{
 "task": "fit",
 "verdict": "rework",
 "headline": "Your setup needs some reworking, beginning with raising the seat by 9 cm to 55 cm.",
 "steps": [
  {
   "part": "chair",
   "do": "Raise the seat by 9 cm to the target height of 55 cm.",
   "why": "This keeps your thighs evenly supported while leaving the keyboard within easy reach.",
   "using": "a sofa cushion"
  },
  {
   "part": "feet",
   "do": "Add a footrest that is 8 cm high under your feet.",
   "why": "With a higher seat, this keeps your feet resting flat instead of hanging unsupported.",
   "using": "a few thick hardback books"
  },
  {
   "part": "screen",
   "do": "Raise the screen's top edge by 33 cm to reach eye level at 133 cm.",
   "why": "This lines up the screen's top edge with your eyes, helping your head stay level.",
   "using": "a laptop stand"
  },
  {
   "part": "distance",
   "do": "Move the screen back by 8 cm to 53 cm from your eyes.",
   "why": "This moves the screen back enough that you can take in the whole screen without leaning forward.",
   "using": "nothing extra needed"
  },
  {
   "part": "laptop",
   "do": "Split the laptop's screen from its keys by using a separate keyboard and raising the laptop.",
   "why": "On a laptop, the screen and the keyboard cannot both sit at the ideal height together.",
   "using": "a spare keyboard and mouse in a drawer"
  }
 ],
 "keep": "The keyboard height is already in range, so you can leave it as it is.",
 "strain": "The neck is tied to the screen, which is changing, and the lower back is tied to the chair, which is changing, so both may feel easier afterward.",
 "habit": "About 5 hours a day at this desk calls for a short break or change of activity of 5 to 10 minutes every hour, getting up and moving around.",
 "closing": "After you make these changes, sit as usual for a while, then measure again and run this check again."
}

{
 "task": "fit",
 "unit": "cm",
 "body": "height 170 cm; lower leg with shoes 46 cm (measured); seat to elbow 24 cm (measured); seat to eye 77 cm (measured)",
 "setup": "A separate screen and keyboard; chair height adjustable: no; desk height adjustable: no",
 "hours": "3",
 "strain": "shoulders, eyes",
 "on_hand": "a firm seat cushion",
 "facts": "verdict: rework\nwhy: rule 2 - the screen needs a change of 10 cm or more\norder of fixes: chair, feet, screen, distance\nin range: keyboard\nchair: seat height now 44 cm, target 51 cm; change: raise by 7 cm - a firm cushion on the seat\nfeet: now no footrest, target a footrest 5 cm high; change: add a footrest 5 cm high - a footrest or a sturdy box\nkeyboard: keyboard surface height (on the desk) now 72 cm, target 72 cm; in range\nscreen: screen top edge now 108 cm, target 128 cm (eye level); change: raise by 20 cm - a monitor riser or a stack of books\ndistance: now 90 cm from the eyes, target 51 to 75 cm; change: move closer by 15 cm to 75 cm - nothing extra, the screen itself slides\nlaptop: not a laptop on its own\nstrain: shoulders -> keyboard (in range); eyes -> distance (to fix)\nbreaks: about 3 hours a day at this desk - a short break or change of activity of 5 to 10 minutes every hour"
}

{
 "task": "fit",
 "verdict": "rework",
 "headline": "Your setup needs reworking, starting with raising the seat height.",
 "steps": [
  {
   "part": "chair",
   "do": "Raise the seat height by 7 cm to reach 51 cm.",
   "why": "This lets your thighs rest evenly on the seat while the keyboard stays within easy reach.",
   "using": "a firm seat cushion"
  },
  {
   "part": "feet",
   "do": "Add a footrest 5 cm high.",
   "why": "Once the seat is higher, your feet can stay flat on the footrest instead of hanging in the air.",
   "using": "a footrest or a sturdy box"
  },
  {
   "part": "screen",
   "do": "Raise the screen top edge by 20 cm to reach 128 cm.",
   "why": "This lines up the top of the screen with your eye height, helping your head stay level.",
   "using": "a monitor riser or a stack of books"
  },
  {
   "part": "distance",
   "do": "Move the screen closer by 15 cm to 75 cm.",
   "why": "This distance keeps the whole screen within view, about an arm's length away, without needing to lean in.",
   "using": "nothing extra"
  }
 ],
 "keep": "The keyboard height is already right, so leave it as it is.",
 "strain": "Shoulder strain is tied to the keyboard, which is already in range and not changing; eye strain is tied to the screen distance, which is in the plan and may become easier.",
 "habit": "At about 3 hours a day at this desk, take a short break or change of activity for 5 to 10 minutes every hour, getting up and moving around.",
 "closing": "Once you make these changes, sit as usual for a while, then measure again and run this check again."
}

{
 "task": "fit",
 "unit": "cm",
 "body": "height 162 cm; lower leg with shoes 43 cm (estimated from height); seat to elbow 23 cm (estimated from height); seat to eye 73 cm (estimated from height)",
 "setup": "A separate screen and keyboard; chair height adjustable: yes; desk height adjustable: no",
 "hours": "6",
 "strain": "wrists or forearms",
 "on_hand": "a shoebox, a yoga block",
 "facts": "verdict: tweak\nwhy: rule 3 - at least one part is out of range and each change is under 10 cm\norder of fixes: chair, feet, screen\nin range: keyboard, distance\nchair: seat height now 48 cm, target 54 cm; change: raise by 6 cm - the chair's height lever\nfeet: now no footrest, target a footrest 11 cm high; change: add a footrest 11 cm high - a footrest or a sturdy box\nkeyboard: keyboard surface height (on the desk) now 74 cm, target 74 cm; in range\nscreen: screen top edge now 120 cm, target 127 cm (eye level); change: raise by 7 cm - a monitor riser or a stack of books\ndistance: now 58 cm from the eyes, target 49 to 71 cm; in range\nlaptop: not a laptop on its own\nstrain: wrists or forearms -> keyboard (in range)\nbreaks: about 6 hours a day at this desk - a short break or change of activity of 5 to 10 minutes every hour"
}

{
 "task": "fit",
 "verdict": "tweak",
 "headline": "A few small changes are needed: raise the chair, add a footrest and raise the screen.",
 "steps": [
  {
   "part": "chair",
   "do": "Raise the chair's seat height by 6 cm to the target of 54 cm.",
   "why": "This keeps your thighs evenly supported while keeping the keyboard within reach.",
   "using": "the chair's height lever"
  },
  {
   "part": "feet",
   "do": "Add a footrest that is 11 cm high.",
   "why": "With the seat higher, the footrest lets your feet rest flat instead of hanging in the air.",
   "using": "a shoebox"
  },
  {
   "part": "screen",
   "do": "Raise the top edge of the screen by 7 cm to the target of 127 cm.",
   "why": "Having the top edge level with your eyes lets your head stay level.",
   "using": "a yoga block"
  }
 ],
 "keep": "The keyboard and the screen distance are already in range, so leave them as they are.",
 "strain": "The wrists or forearms are linked to the keyboard, which is already in range and is not changing.",
 "habit": "At about 6 hours a day at this desk, take a short break or change of activity of 5 to 10 minutes every hour, getting up and moving around.",
 "closing": "Once these changes are in place, sit normally for a while, then measure your setup again and repeat this check."
}

{
 "task": "fit",
 "unit": "in",
 "body": "height 74 in; lower leg with shoes 19.5 in (estimated from height); seat to elbow 10.5 in (estimated from height); seat to eye 33.5 in (estimated from height)",
 "setup": "A raised laptop with a separate keyboard; chair height adjustable: yes; desk height adjustable: yes",
 "hours": "8",
 "strain": "none ticked",
 "on_hand": "none",
 "facts": "verdict: fits\nwhy: rule 4 - every part is in range\norder of fixes: none\nin range: chair, keyboard, screen, distance\nchair: seat height now 20 in, target 20 in; in range\nfeet: now no footrest; in range\nkeyboard: keyboard surface height (on the desk) now 29.5 in, target 29 in; in range\nscreen: screen top edge now 52 in, target 53.5 in (eye level); in range\ndistance: now 27 in from the eyes, target 22 to 32.5 in; in range\nlaptop: not a laptop on its own\nstrain: none ticked\nbreaks: about 8 hours a day at this desk - a short break or change of activity of 5 to 10 minutes every hour"
}

{
 "task": "fit",
 "verdict": "fits",
 "headline": "Everything about your setup already fits, with no changes needed.",
 "steps": [],
 "keep": "The chair, keyboard, screen and screen distance are all in range, so leave them as they are.",
 "strain": "",
 "habit": "At about 8 hours a day at this desk, take a short break or change of activity of 5 to 10 minutes every hour, getting up and moving around.",
 "closing": "If you make changes later, keep sitting normally for a while, then take fresh measurements and run this check again."
}

const K = FitKit;
const form = K.form({ unit: "cm", height: "170", setup: "monitor", seat: "45", desk: "74", screen: "112", dist: "65",
  chairAdj: true, deskAdj: false, hours: "6", strain: { neck: true }, onHand: "a few thick books" });
const built = K.buildInput(form);       // built.facts holds the targets, the order and the verdict
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 plan as Markdown

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

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

# input.json: the run input object - {"task": "fit", "unit": "cm", "body": "...", "setup": "...", "hours": "6", "strain": "...", "on_hand": "...", "facts": "...", ...}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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