Drive Full Loft from your own code

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

{"task": "loft-check", "headline": "...", "items": [{"item": 1, "route": "wash", "likely_cause": "...", "first_move": "...", "check_after": "..."}, ...], "order": "...", "closing": "..."}

{
 "task": "loft-check",
 "jacket": "long black puffer",
 "fill": "down",
 "care_label": "machine wash allowed",
 "last_washed": "over a year ago",
 "signs": "item 1 | where: chest | sign: flat or thin, no lumps | noticed: never really sprang back after summer in the wardrobe | page route: wash\nitem 2 | where: sleeves or cuffs | sign: a single feather or quill poking through | noticed: nothing added | page route: tuck\nitem 3 | where: sleeves or cuffs | sign: grubby or shiny patches | noticed: shiny cuffs | page route: spot\nitem 4 | where: back | sign: a cold spot when worn | noticed: nothing added | page route: fluff",
 "facts": "try first: item 2 (tuck, the lightest fix here)\nheaviest step: item 1 (wash)\nroutes: tuck 1, fluff 1, spot 1, patch 0, dry 0, wash 1, pro 0\nneeds a wash or a cleaner: 1 of 4 signs"
}

{
 "task": "loft-check",
 "headline": "Just 1 of 4 signs on your long black puffer needs a wash or a cleaner.",
 "items": [
  {
   "item": 1,
   "route": "wash",
   "likely_cause": "Probably the down at your chest hasn't regained loft since summer in the wardrobe, matching no wash in over a year.",
   "first_move": "Give the jacket a gentle wash on a cool cycle, either in the machine or using your hands, with a soap made for down, then dry it fully so the chest regains its loft.",
   "check_after": "Once fully dry, feel the chest again for springy loft instead of the flat, thin feel."
  },
  {
   "item": 2,
   "route": "tuck",
   "likely_cause": "Probably a stray down feather or quill has worked its way out through the fabric at your sleeve or cuff, not a wider tear.",
   "first_move": "At that sleeve or cuff, reach inside the fabric with a fingertip and gently push the stray feather back through, rather than pulling it out from outside, since pulling only enlarges the opening.",
   "check_after": "Check that area again soon after: if no feather or quill tip is visible or felt, it worked."
  },
  {
   "item": 3,
   "route": "spot",
   "likely_cause": "Probably built-up body oils and grime have made your cuffs grubby and shiny there, not a wider soiling needing a full wash.",
   "first_move": "On those shiny cuffs, wipe the grubby area with a damp cloth and a touch of mild soap, working gently, then leave it to air dry completely.",
   "check_after": "Once dry, look at the cuffs for less shine or grime; repeat lightly if any dull mark remains."
  },
  {
   "item": 4,
   "route": "fluff",
   "likely_cause": "Probably some of the down fill near your back has shifted toward a section of the jacket, leaving that back area thinner and less warm.",
   "first_move": "Give the jacket a firm shake, then use your hands to loosen and redistribute the fill into the back where it feels empty, then let the jacket hang freely.",
   "check_after": "Put the jacket on again and feel that section of your back for even warmth instead of a cold spot."
  }
 ],
 "order": "Start with item 2, since tucking the feather back in is the simplest first step, then move to item 3, item 4, and finish with item 1, the biggest job here.",
 "closing": "Your long black puffer has quick fixes within reach, so start with that stray feather and see how it feels."
}

{
 "task": "loft-check",
 "jacket": "hooded parka",
 "fill": "down and feather",
 "care_label": "hand wash only",
 "last_washed": "within the last year",
 "signs": "item 1 | where: all over | sign: got soaked and is still damp | noticed: caught in heavy rain yesterday | page route: dry\nitem 2 | where: back | sign: lumps or clumps of fill | noticed: hard lumps low on the back | page route: dry\nitem 3 | where: sleeves or cuffs | sign: fill escaping from a hole or seam | noticed: small tear by the elbow | page route: patch\nitem 4 | where: hood or collar | sign: smells musty or stale | noticed: nothing added | page route: wash",
 "facts": "try first: item 1 (dry, damp fill dries before anything else)\nheaviest step: item 4 (wash)\nroutes: tuck 0, fluff 0, spot 0, patch 1, dry 2, wash 1, pro 0\nneeds a wash or a cleaner: 1 of 4 signs"
}

{
 "task": "loft-check",
 "headline": "1 of 4 signs need a wash or a cleaner for your hooded parka.",
 "items": [
  {
   "item": 1,
   "route": "dry",
   "likely_cause": "Heavy rain yesterday most likely soaked the down and feather fill all over, so it's still damp and needs full drying before anything else.",
   "first_move": "Hang the hooded parka in a spot with plenty of airflow, turning it from time to time so it dries right through.",
   "check_after": "Feel all over for cool or damp patches and check none remain before moving on."
  },
  {
   "item": 2,
   "route": "dry",
   "likely_cause": "The hard lumps low on your back are most likely down and feather fill that clumped together after drying unevenly.",
   "first_move": "Hang the hooded parka somewhere airy and work the hard lumps apart with your hands every little while until the back feels evenly filled, not hard in patches.",
   "check_after": "Feel the back again - it should feel evenly soft, with no hard lumps left."
  },
  {
   "item": 3,
   "route": "patch",
   "likely_cause": "A small tear by the elbow on the sleeves or cuffs is most likely letting fill escape from inside.",
   "first_move": "Close the small tear by the elbow on the sleeves or cuffs using a patch or a bit of careful stitching so the fill stays put.",
   "check_after": "Check the tear by the elbow for any fresh down or feather poking through before wearing it again."
  },
  {
   "item": 4,
   "route": "wash",
   "likely_cause": "The musty or stale smell at your hood or collar is probably moisture that has built up in the fill.",
   "first_move": "Wash the hooded parka by hand in cool water, giving the hood or collar extra attention with a gentle soap meant for down, then rinse it well and dry it fully before wearing again.",
   "check_after": "Once it's dry, smell near the hood or collar again to see if the musty smell has gone."
  }
 ],
 "order": "Start with item 1 because the fill is still damp and needs to dry before anything else, then patch item 3, work on item 2, and finish washing with item 4.",
 "closing": "Give your hooded parka a little care, starting with the damp area first - the rest can follow."
}

{
 "task": "loft-check",
 "jacket": "cream cropped puffer",
 "fill": "down",
 "care_label": "dry clean only",
 "last_washed": "never, or not sure",
 "signs": "item 1 | where: all over | sign: flat or thin, no lumps | noticed: nothing added | page route: pro\nitem 2 | where: hood or collar | sign: smells musty or stale | noticed: collar smells stale | page route: pro\nitem 3 | where: hem | sign: a single feather or quill poking through | noticed: quill keeps poking out near the zip | page route: tuck",
 "facts": "try first: item 3 (tuck, the lightest fix here)\nheaviest step: item 1 (pro)\nroutes: tuck 1, fluff 0, spot 0, patch 0, dry 0, wash 0, pro 2\nneeds a wash or a cleaner: 2 of 3 signs"
}

{
 "task": "loft-check",
 "headline": "2 of 3 signs on this cream cropped puffer need a wash or a cleaner.",
 "items": [
  {
   "item": 1,
   "route": "pro",
   "likely_cause": "All over, the down has probably thinned evenly with no lumps, likely from going a long time with no known wash.",
   "first_move": "With the label allowing only a cleaner's help, drop the cream cropped puffer off with a cleaner who works with down, covering it all over.",
   "check_after": "After the cleaner returns it, check that it feels fuller and less flat all over."
  },
  {
   "item": 2,
   "route": "pro",
   "likely_cause": "The collar smells stale, probably because odour has built up in the down fill with no known wash to clear it.",
   "first_move": "Take it to a cleaner used to down jackets, pointing out the stale smell at the hood or collar for them to treat.",
   "check_after": "Once the cleaner has treated it, check that the hood or collar no longer smells musty or stale."
  },
  {
   "item": 3,
   "route": "tuck",
   "likely_cause": "Near the zip at the hem, a quill from the down fill has probably worked through the fabric, which is why it keeps poking out.",
   "first_move": "At the hem near the zip, gently push the quill back through the fabric from the inside, rather than pulling it free, to keep the hole from growing.",
   "check_after": "Look at that spot on the hem to see the quill stays tucked in and doesn't poke back out."
  }
 ],
 "order": "Start with item 3, tucking the quill back in since it's the lightest fix here, then plan a cleaner's visit to cover item 2 and item 1.",
 "closing": "Tucking that quill back in at the hem is a simple place to start with the cream cropped puffer."
}

const K = LoftKit;
const built = K.buildInput(K.form({ jacket: "long black puffer", fill: "down", label: "machine", washed: "old",
  items: [{ where: "chest", sign: "flat", note: "" }, { where: "sleeves", sign: "feather", note: "" }] }));
built.input.facts;                      // the page's lines: try first, heaviest step, route counts
const wire = K.toWire(built.input);     // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// built.facts.items[0].route           // the route the page's rule gives
// K.check(reply, built).notes          // the page's re-check of the reply
// K.md(built, reply, "my jacket")      // the check as Markdown

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

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

# input.json: the run input object - {"task": "loft-check", "jacket": "long black puffer", "fill": "down", "care_label": "machine wash allowed", "last_washed": "over a year ago", "signs": "item 1 | where: chest | ...", "facts": "try first: item 1 ..."}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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