Drive Nap Ticket from your own code

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

{"task": "plan", "title": "...", "verdict": "power_nap", "verdict_reason": "...", "lie_down": "15:00", "alarm": "15:30",
 "before": ["...", "..."], "wake": ["...", "..."], "if_awake": "...", "caution": "...", "tonight": "...", "announcement": "..."}

{
 "task": "plan",
 "free_from": "13:30",
 "back_by": "14:30",
 "bedtime": "23:00",
 "last_night": "5 to 6 hours",
 "next": "focused work or study",
 "coffee": "no caffeine",
 "note": "I lie awake until 2 most nights and then drag through the afternoon. Big report due by five.",
 "page_facts": "window | 60 minutes from 13:30 to 14:30; bedtime 23:00 is 9 h 30 min after 13:30\nquiet_rest | fits: lie down 13:30, timer 13:50 (eyes closed, no need to sleep)\npower_nap | fits: lie down 13:30, alarm 14:00 (about 20 minutes asleep), clear-headed by about 14:10; ends 9 h before bedtime\ncoffee_nap | does not fit: no caffeine chosen\nfull_cycle | does not fit: needs 115 minutes, the window is 60\ntrouble_sleeping_hint | the note seems to mention trouble sleeping at night (a hint only - read the note)\npage_pick | power_nap (the rule applied without reading the note)\nverdict_rule | check in order and stop at the first that fits: quiet_rest when no nap fare fits, or when the note says the person often has trouble falling or staying asleep at night; full_cycle when full_cycle fits and last night was under 6 hours or a late night or night shift is next; coffee_nap when coffee_nap fits and either driving or focused work or study is next, or power_nap does not fit; otherwise power_nap"
}

{
 "task": "plan",
 "title": "Quiet Rest Before the Big Report",
 "verdict": "quiet_rest",
 "verdict_reason": "Your note says you lie awake until 2 most nights, which is ongoing trouble sleeping, so quiet rest beats the power nap that fits your window.",
 "lie_down": "13:30",
 "alarm": "13:50",
 "before": [
  "Set your timer for 13:50.",
  "Silence your notifications.",
  "Dim or block the light.",
  "Loosen any tight clothing, lie down, and take a few slow breaths."
 ],
 "wake": [
  "Get up as soon as the timer sounds.",
  "Step into bright light or daylight.",
  "Drink a glass of water.",
  "Take a short walk or stretch before getting back to your report."
 ],
 "if_awake": "Sleep isn't the goal here; resting with eyes closed still helps. Keep the timer where it is, and don't stretch this past it.",
 "caution": "",
 "tonight": "Keep tonight's bedtime at 23:00 as planned; a short quiet rest now won't get in the way.",
 "announcement": "Next stop: quiet rest, 13:30 to 13:50. Eyes closed, no sleep required, back on track for your report."
}

{
 "task": "plan",
 "free_from": "13:00",
 "back_by": "15:00",
 "bedtime": "22:30",
 "last_night": "under 5 hours",
 "next": "time with people or being active",
 "coffee": "no caffeine",
 "note": "Up three times in the night with a teething baby. My partner has her until three, then we're going to the park.",
 "page_facts": "window | 120 minutes from 13:00 to 15:00; bedtime 22:30 is 9 h 30 min after 13:00\nquiet_rest | fits: lie down 13:00, timer 13:20 (eyes closed, no need to sleep)\npower_nap | fits: lie down 13:00, alarm 13:30 (about 20 minutes asleep), clear-headed by about 13:40; ends 9 h before bedtime\ncoffee_nap | does not fit: no caffeine chosen\nfull_cycle | fits: lie down 13:00, alarm 14:40 (about 90 minutes asleep), clear-headed by about 14:55; ends 7 h 50 min before bedtime\ntrouble_sleeping_hint | none found in the note (a hint only - read the note)\npage_pick | full_cycle (the rule applied without reading the note)\nverdict_rule | check in order and stop at the first that fits: quiet_rest when no nap fare fits, or when the note says the person often has trouble falling or staying asleep at night; full_cycle when full_cycle fits and last night was under 6 hours or a late night or night shift is next; coffee_nap when coffee_nap fits and either driving or focused work or study is next, or power_nap does not fit; otherwise power_nap"
}

{
 "task": "plan",
 "title": "Recharge Before Park Time With Baby",
 "verdict": "full_cycle",
 "verdict_reason": "The full cycle fits the window, and last night was under 5 hours, so a full cycle nap is the call over a shorter power nap.",
 "lie_down": "13:00",
 "alarm": "14:40",
 "before": [
  "Silence notifications so the next 90 minutes stay undisturbed.",
  "Dim or block out the light around you.",
  "Set your alarm for 14:40, now your partner has her until three.",
  "Lie down, loosen anything tight, and take a few slow breaths."
 ],
 "wake": [
  "Get up as soon as the 14:40 alarm sounds, no snoozing.",
  "Step into bright light or daylight right away.",
  "Drink a glass of water to help you feel alert.",
  "Any grogginess should lift by about 14:55, in time for the park."
 ],
 "if_awake": "If sleep doesn't come, just rest with your eyes closed - that still helps. Leave the alarm where it is and don't stretch the nap longer.",
 "caution": "",
 "tonight": "Keep tonight's bedtime at 22:30, no matter how the day with the baby and park goes.",
 "announcement": "Next stop: a 90-minute full cycle from 13:00 to 14:40, then on to the park with the baby."
}

{
 "task": "plan",
 "free_from": "14:00",
 "back_by": "14:40",
 "bedtime": "23:30",
 "last_night": "6 to 7 hours",
 "next": "focused work or study",
 "coffee": "a coffee right before is fine",
 "note": "Afternoon slump before a long study block for my statistics exam. My eyes keep closing over my notes.",
 "page_facts": "window | 40 minutes from 14:00 to 14:40; bedtime 23:30 is 9 h 30 min after 14:00\nquiet_rest | fits: lie down 14:00, timer 14:20 (eyes closed, no need to sleep)\npower_nap | fits: lie down 14:00, alarm 14:30 (about 20 minutes asleep), clear-headed by about 14:40; ends 9 h before bedtime\ncoffee_nap | fits: coffee at 14:00, lie down 14:05, alarm 14:25 (about 10 minutes asleep), clear-headed by about 14:35; ends 9 h 5 min before bedtime\nfull_cycle | does not fit: needs 115 minutes, the window is 40\ntrouble_sleeping_hint | none found in the note (a hint only - read the note)\npage_pick | coffee_nap (the rule applied without reading the note)\nverdict_rule | check in order and stop at the first that fits: quiet_rest when no nap fare fits, or when the note says the person often has trouble falling or staying asleep at night; full_cycle when full_cycle fits and last night was under 6 hours or a late night or night shift is next; coffee_nap when coffee_nap fits and either driving or focused work or study is next, or power_nap does not fit; otherwise power_nap"
}

{
 "task": "plan",
 "title": "Beat the Statistics Exam Slump",
 "verdict": "coffee_nap",
 "verdict_reason": "A coffee nap fits your 40-minute window, and focused study is next, so a quick coffee before a short nap sets you up well.",
 "lie_down": "14:05",
 "alarm": "14:25",
 "before": [
  "Drink a regular cup of coffee quickly, right away at 14:00, before lying down.",
  "Set your alarm for 14:25 so you wake on time.",
  "Set your notes aside and silence notifications before lying down.",
  "Dim the lights and lie down for your nap at 14:05."
 ],
 "wake": [
  "Get up as soon as the 14:25 alarm goes off.",
  "Step into bright daylight or switch on a bright light to feel alert.",
  "Drink a glass of water before returning to your notes.",
  "Any grogginess should lift by about 14:35, clear-headed for study."
 ],
 "if_awake": "If sleep doesn't come, just rest with your eyes closed - it still helps. Leave the alarm as set; don't stretch the nap longer.",
 "caution": "",
 "tonight": "Keep tonight's bedtime at 23:30 as planned - this short nap won't get in the way.",
 "announcement": "Next stop: a 14:05 coffee nap, arriving clear-headed by 14:35 for your statistics exam."
}

{
 "task": "plan",
 "free_from": "15:00",
 "back_by": "15:45",
 "bedtime": "22:00",
 "last_night": "7 hours or more",
 "next": "driving",
 "coffee": "no caffeine",
 "note": "Long morning of yard work and I'm fading. Driving to pick up my sister from the station at four.",
 "page_facts": "window | 45 minutes from 15:00 to 15:45; bedtime 22:00 is 7 h after 15:00\nquiet_rest | fits: lie down 15:00, timer 15:20 (eyes closed, no need to sleep)\npower_nap | fits: lie down 15:00, alarm 15:30 (about 20 minutes asleep), clear-headed by about 15:40; ends 6 h 30 min before bedtime\ncoffee_nap | does not fit: no caffeine chosen\nfull_cycle | does not fit: needs 115 minutes, the window is 45\ntrouble_sleeping_hint | none found in the note (a hint only - read the note)\ndrive_wait | after waking, wait at least 15 minutes before driving, and do not drive while still drowsy\npage_pick | power_nap (the rule applied without reading the note)\nverdict_rule | check in order and stop at the first that fits: quiet_rest when no nap fare fits, or when the note says the person often has trouble falling or staying asleep at night; full_cycle when full_cycle fits and last night was under 6 hours or a late night or night shift is next; coffee_nap when coffee_nap fits and either driving or focused work or study is next, or power_nap does not fit; otherwise power_nap"
}

{
 "task": "plan",
 "title": "Yard Work Recovery Nap Before Your Drive",
 "verdict": "power_nap",
 "verdict_reason": "Full cycle needs far more than your 45-minute window, and no caffeine rules out a coffee nap, so a power nap fits best.",
 "lie_down": "15:00",
 "alarm": "15:30",
 "before": [
  "Set your alarm for 15:30, right where you'll hear it.",
  "Dim the light, silence notifications, and lie down to rest.",
  "Loosen any tight clothing and take a few slow breaths."
 ],
 "wake": [
  "Get up as soon as the alarm goes off.",
  "Step into bright light or daylight to help you wake.",
  "Have a glass of water before you get moving.",
  "Any grogginess should lift by about 15:40."
 ],
 "if_awake": "If sleep doesn't come, just rest with your eyes closed; it still helps. Keep the alarm set, and don't stretch the nap longer.",
 "caution": "Wait at least 15 minutes after waking before you drive, and don't drive while still drowsy.",
 "tonight": "This nap won't get in the way of tonight; keep your bedtime at 22:00 as planned.",
 "announcement": "Next stop: 15:00 for lie-down, 15:30 for wake-up, right on time for your sister's station pickup at four."
}

const K = NapKit;
const built = K.buildInput({ free_from: "15:00", back_by: "15:45", bedtime: "22:00", last_night: "h7_plus", next: "drive", coffee: "no",
  note: "Long morning of yard work and I'm fading. Driving to pick up my sister from the station at four." });
built.fs.power_nap;                              // { fits: true, lie_down: "15:00", alarm: "15:30", clear_by: "15:40", stops: [...] } - the free fare board
built.pick;                                      // "power_nap" - the rule applied without reading the note
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 ticket
// K.ics(built, reply, reply.title)              // a calendar event from lying down to the alarm

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

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

# input.json: the run input object - {"task": "plan", "free_from": "15:00", "back_by": "15:45", "bedtime": "22:00", "note": "...", "page_facts": "...", ...} - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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