Drive Paddling Below from your own code

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

{"task": "blueprint", "verdict": "snag-below", "headline": "...", "out_of_sight": "...", "snag_note": "...", "wait_note": "...", "fix_for_them": "...", "ask_next_time": "..."}

{
 "task": "blueprint",
 "service": "Collecting a parcel from the depot | note: none",
 "steps": "1. Queued at the collection counter | lane: you | minutes: 15 | you were waiting: yes | went wrong: no\n2. Showed the card and my ID | lane: you | minutes: 2 | you were waiting: no | went wrong: no\n3. Clerk scanned the card | lane: in front of you | minutes: 1 | you were waiting: no | went wrong: no\n4. Clerk went into the back to look | lane: out of sight | minutes: 12 | you were waiting: yes | went wrong: no | seen or told\n5. Parcel not on the shelf the scanner showed | lane: out of sight | minutes: 8 | you were waiting: yes | went wrong: yes | seen or told\n6. Shelf locations kept in the depot system | lane: what it runs on | minutes: 0 | you were waiting: no | went wrong: no | your guess\n7. Clerk handed over the parcel | lane: in front of you | minutes: 2 | you were waiting: no | went wrong: no",
 "facts": "Total: 40 minutes over 7 steps.\nLanes: you 2, in front of you 2, out of sight 2, what it runs on 1. Your guesses below the waterline (whole service): 1 of 3.\nWaiting: 35 minutes of 40 minutes (88%), at steps 1, 4, 5. Longest wait: step 1 \"Queued at the collection counter\", 15 minutes.\nWaterline crossings: 2 (out of your sight 1 time, back into view 1 time).\nLongest stretch out of sight: steps 4 to 6 (\"Clerk went into the back to look\" to \"Shelf locations kept in the depot system\"), 20 minutes, 3 steps.\nSnags: 1 - step 5 \"Parcel not on the shelf the scanner showed\" (out of sight).\nVerdict: snag-below (checked in order: a snag out of sight or in what it runs on is snag-below; else a snag in your lane or in front of you is snag-in-view; else waiting of half the minutes or more is long-paddle; else smooth-glide)\nFix for whoever runs it: step 5 \"Parcel not on the shelf the scanner showed\" - the first snag out of sight.\nQuestion for you to ask: about step 6 \"Shelf locations kept in the depot system\" (your first guess), asked at step 3 \"Clerk scanned the card\"."
}

{
 "task": "blueprint",
 "verdict": "snag-below",
 "headline": "Over 40 minutes, something went wrong out of your sight, with waiting taking up 88% of that time.",
 "out_of_sight": "The longest stretch out of sight ran from the clerk going into the back to look to your guess that shelf locations are kept in the depot system, lasting 20 minutes, and only 1 of the 3 steps below the waterline in the whole service is your guess.",
 "snag_note": "The snag was that the parcel was not on the shelf the scanner showed, out of sight.",
 "wait_note": "The longest wait was spent queued at the collection counter, 15 minutes, and waiting took up 88% of the time overall.",
 "fix_for_them": "At the step where the parcel was not on the shelf the scanner showed, whoever runs it could add a habit of checking that shelf a second time.",
 "ask_next_time": "Next time, as the clerk scans the card, you could check your guess that shelf locations are kept in the depot system by asking, \"Are shelf locations kept in the depot system?\""
}

{
 "task": "blueprint",
 "service": "A walk-in haircut | note: First visit to this barber.",
 "steps": "1. Gave my name at the desk | lane: you | minutes: 1 | you were waiting: no | went wrong: no\n2. Receptionist wrote it on the walk-in list | lane: in front of you | minutes: 1 | you were waiting: no | went wrong: no\n3. Walk-in list kept on a clipboard | lane: what it runs on | minutes: 0 | you were waiting: no | went wrong: no | seen or told\n4. Waited on the sofa | lane: you | minutes: 25 | you were waiting: yes | went wrong: no\n5. Barbers took the next name in turn | lane: out of sight | minutes: 0 | you were waiting: no | went wrong: no | your guess\n6. Barber called the wrong name | lane: in front of you | minutes: 2 | you were waiting: no | went wrong: yes\n7. Haircut and a quick wash | lane: in front of you | minutes: 30 | you were waiting: no | went wrong: no\n8. Paid at the desk | lane: you | minutes: 3 | you were waiting: no | went wrong: no",
 "facts": "Total: 62 minutes over 8 steps.\nLanes: you 3, in front of you 3, out of sight 1, what it runs on 1. Your guesses below the waterline (whole service): 1 of 2.\nWaiting: 25 minutes of 62 minutes (40%), at step 4. Longest wait: step 4 \"Waited on the sofa\", 25 minutes.\nWaterline crossings: 4 (out of your sight 2 times, back into view 2 times).\nLongest stretch out of sight: step 3 \"Walk-in list kept on a clipboard\", 0 minutes, 1 step.\nSnags: 1 - step 6 \"Barber called the wrong name\" (in front of you).\nVerdict: snag-in-view (checked in order: a snag out of sight or in what it runs on is snag-below; else a snag in your lane or in front of you is snag-in-view; else waiting of half the minutes or more is long-paddle; else smooth-glide)\nFix for whoever runs it: step 6 \"Barber called the wrong name\" - the first snag in view.\nQuestion for you to ask: about step 5 \"Barbers took the next name in turn\" (your first guess), asked at step 2 \"Receptionist wrote it on the walk-in list\"."
}

{
 "task": "blueprint",
 "verdict": "snag-in-view",
 "headline": "Across 62 minutes, something went wrong in a step where you could see it, with waiting making up 40% of the total time.",
 "out_of_sight": "The longest stretch out of sight is the walk-in list kept on a clipboard, which took no minutes you counted, and 1 of the 2 steps below the waterline in the whole service is your guess.",
 "snag_note": "In front of you, the barber called the wrong name.",
 "wait_note": "The longest wait was when you waited on the sofa for 25 minutes, which was 40% of the total time.",
 "fix_for_them": "For the barber, a small habit of checking the name against the walk-in list just before calling it out - at the step where the barber called the wrong name - could be worth trying.",
 "ask_next_time": "Next time, when the receptionist writes your name on the walk-in list, you could check your guess by asking, \"Do barbers take the next name in turn?\""
}

{
 "task": "blueprint",
 "service": "Puncture repair at the bike shop | note: none",
 "steps": "1. Wheeled the bike to the counter | lane: you | minutes: 2 | you were waiting: no | went wrong: no\n2. Mechanic wrote a repair ticket | lane: in front of you | minutes: 3 | you were waiting: no | went wrong: no\n3. Bike waited in the repair queue | lane: out of sight | minutes: 40 | you were waiting: yes | went wrong: no | your guess\n4. Repair tickets pinned on a workshop board | lane: what it runs on | minutes: 0 | you were waiting: no | went wrong: no | your guess\n5. Inner tube swapped in the workshop | lane: out of sight | minutes: 15 | you were waiting: yes | went wrong: no | your guess\n6. Phone call to say it was ready | lane: in front of you | minutes: 1 | you were waiting: no | went wrong: no\n7. Paid and rode off | lane: you | minutes: 4 | you were waiting: no | went wrong: no",
 "facts": "Total: 65 minutes over 7 steps.\nLanes: you 2, in front of you 2, out of sight 2, what it runs on 1. Your guesses below the waterline (whole service): 3 of 3.\nWaiting: 55 minutes of 65 minutes (85%), at steps 3, 5. Longest wait: step 3 \"Bike waited in the repair queue\", 40 minutes.\nWaterline crossings: 2 (out of your sight 1 time, back into view 1 time).\nLongest stretch out of sight: steps 3 to 5 (\"Bike waited in the repair queue\" to \"Inner tube swapped in the workshop\"), 55 minutes, 3 steps.\nSnags: none.\nVerdict: long-paddle (checked in order: a snag out of sight or in what it runs on is snag-below; else a snag in your lane or in front of you is snag-in-view; else waiting of half the minutes or more is long-paddle; else smooth-glide)\nFix for whoever runs it: step 3 \"Bike waited in the repair queue\" - the longest wait.\nQuestion for you to ask: about step 3 \"Bike waited in the repair queue\" (your first guess), asked at step 2 \"Mechanic wrote a repair ticket\"."
}

{
 "task": "blueprint",
 "verdict": "long-paddle",
 "headline": "Nothing went wrong across 65 minutes of this service, but waiting took up 85% of the time.",
 "out_of_sight": "The longest stretch out of sight runs from your guess that the bike waited in the repair queue to your guess that the inner tube was swapped in the workshop, lasting 55 minutes, and 3 of the 3 steps below the waterline in this whole service are your guesses.",
 "snag_note": "",
 "wait_note": "The longest wait is your guess that the bike waited in the repair queue for 40 minutes, part of the 85% of the whole time spent waiting.",
 "fix_for_them": "Whoever runs it could find a way to let you know what is happening, or roughly how long it will take, during what you guessed was the bike waiting in the repair queue.",
 "ask_next_time": "Next time, as the mechanic writes the repair ticket, you could ask, \"Does the bike wait in a repair queue before the repair starts?\""
}

{
 "task": "blueprint",
 "service": "Renewing my library card | note: The old card had expired.",
 "steps": "1. Handed the old card over at the desk | lane: you | minutes: 1 | you were waiting: no | went wrong: no\n2. Librarian checked my address | lane: in front of you | minutes: 2 | you were waiting: no | went wrong: no\n3. Account renewed in the library system | lane: what it runs on | minutes: 1 | you were waiting: no | went wrong: no | your guess\n4. New card printed behind the desk | lane: out of sight | minutes: 2 | you were waiting: yes | went wrong: no | seen or told\n5. Signed the back of the new card | lane: you | minutes: 1 | you were waiting: no | went wrong: no",
 "facts": "Total: 7 minutes over 5 steps.\nLanes: you 2, in front of you 1, out of sight 1, what it runs on 1. Your guesses below the waterline (whole service): 1 of 2.\nWaiting: 2 minutes of 7 minutes (29%), at step 4. Longest wait: step 4 \"New card printed behind the desk\", 2 minutes.\nWaterline crossings: 2 (out of your sight 1 time, back into view 1 time).\nLongest stretch out of sight: steps 3 to 4 (\"Account renewed in the library system\" to \"New card printed behind the desk\"), 3 minutes, 2 steps.\nSnags: none.\nVerdict: smooth-glide (checked in order: a snag out of sight or in what it runs on is snag-below; else a snag in your lane or in front of you is snag-in-view; else waiting of half the minutes or more is long-paddle; else smooth-glide)\nFix for whoever runs it: step 4 \"New card printed behind the desk\" - the longest wait.\nQuestion for you to ask: about step 3 \"Account renewed in the library system\" (your first guess), asked at step 2 \"Librarian checked my address\"."
}

{
 "task": "blueprint",
 "verdict": "smooth-glide",
 "headline": "This service went without any snags, taking 7 minutes in all, with 29% of that time spent waiting - well under half.",
 "out_of_sight": "The longest stretch out of sight ran from your guess that the account was renewed in the library system to the new card being printed behind the desk, taking 3 minutes, and of the 2 steps below the waterline in the whole service, 1 is your guess.",
 "snag_note": "",
 "wait_note": "The longest wait was while the new card was printed behind the desk, which took 2 minutes, part of the 29% of the service spent waiting.",
 "fix_for_them": "While the new card is printed behind the desk, whoever runs it could let you know roughly how long that wait will be.",
 "ask_next_time": "Next time, as the librarian checks your address, you could ask, \"Has the account already been renewed in the library system?\""
}

const K = PondKit, R = ReplyKit;
const built = K.buildInput(K.form({ name: "Getting a spare key cut", note: "", steps: [
  { what: "Handed over the key", lane: "you", mins: 1 },
  { what: "Key cut on the machine", lane: "front", mins: 4, wait: true },
  { what: "Blank keys kept in a drawer", lane: "base", mins: 0, guess: true } ] }));  // built.ok is false, with built.note, until the steps are ready
const wire = K.toWire(built.input);   // POST this to /estimate and /run; built.analysis holds total, waitPct, stretch, snags, verdict
// then: const reply = R.normalize(R.parseReply(job.output.output));
// R.check(reply, built).notes        // the page's re-check of the reply
// R.md(built, reply, K.title(built.form))   // the steps, the numbers and the reading as Markdown

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

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

# input.json: the run input object - {"task": "blueprint", "service": "Collecting a parcel from the depot | note: none", "steps": "1. Queued at the collection counter | lane: you | minutes: 15 | you were waiting: yes | went wrong: no ...", "facts": "...", ...}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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