Drive Between Hours from your own code

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

{"task": "read", "title": "...", "cues_counted": ["passing", "empty"],
 "verdict": "deeply_liminal | at_the_right_hour | just_a_place", "verdict_reason": "...", "reading": "...",
 "signs": [{"cue": "passing", "seen": "..."}], "best_hours": {"when": "early", "why": "..."},
 "tip_more": "...", "visit_note": "..."}

{
 "task": "read",
 "place": "The back stairwell at my office building, which I take at 7am before anyone else is in. Eight identical landings, each with the same grey fire door and the same painted floor number. The lights are long strip lights that buzz faintly, and every footstep echoes up and down the shaft.",
 "kind": "stairwell",
 "when": "early",
 "cues": "passing, empty, light, repeat, hush",
 "page_facts": "kind | a stairwell\nwhen | early morning\nticked | passing, empty, light, repeat, hush - the person's own switches; always count these\nwords_suggest | none - the page's word match on the description and the kind of place, a hint that can be wrong\nbusy_words | no\ncue_ids | passing = built for passing through or waiting; crowd = built for a crowd that is not there; empty = nobody else around; light = flat or buzzing artificial light; repeat = repeating doors, tiles or rows; sealed = no windows or no clock; familiar = feels familiar from childhood; hush = a hum, an echo or a hush\nverdict_rule | check in order and stop at the first that fits: 1) just_a_place when neither passing nor crowd is counted; 2) deeply_liminal when passing or crowd is counted AND empty is counted AND at least one of light, repeat, sealed, familiar, hush is counted; 3) otherwise at_the_right_hour\npage_verdict | deeply_liminal (from the ticked switches alone)"
}

{
 "task": "read",
 "title": "Eight Identical Landings, All to Yourself",
 "cues_counted": [
  "passing",
  "empty",
  "light",
  "repeat",
  "hush"
 ],
 "verdict": "deeply_liminal",
 "verdict_reason": "It's built for passing through, with nobody else around this early, and buzzing lights, repeating landings and echoing footsteps make it feel fully in-between.",
 "reading": "A stairwell is designed for passing through, not lingering, yet at 7am you walk it entirely alone - every identical landing, buzzing lights, and echoing step amplifying how in-between this passing-through space feels.",
 "signs": [
  {
   "cue": "repeat",
   "seen": "Eight identical landings, each with the same grey door and floor number"
  },
  {
   "cue": "hush",
   "seen": "Every footstep echoes up and down the stairwell shaft"
  },
  {
   "cue": "light",
   "seen": "Long strip lights buzz faintly through the stairwell"
  },
  {
   "cue": "empty",
   "seen": "You take this stairwell at 7am before anyone else is in"
  }
 ],
 "best_hours": {
  "when": "early",
  "why": "At 7am, before anyone else arrives, the identical landings and echoing footsteps feel most in-between."
 },
 "tip_more": "Pause on a landing and listen to how your footsteps echo before you continue up or down.",
 "visit_note": "Use the stairwell only when you're meant to be in the building, keep the fire doors clear, and leave if someone asks."
}

{
 "task": "read",
 "place": "The indoor pool at the leisure centre during the last lane swim before closing, when I'm usually the only one left. Rows of empty spectator benches, the water perfectly still, no windows at all, and that chlorine smell from school swimming lessons. The only sound is the filter humming.",
 "kind": "pool",
 "when": "late",
 "cues": "crowd, empty, light, sealed, familiar, hush",
 "page_facts": "kind | an indoor pool or leisure centre\nwhen | late at night\nticked | crowd, empty, light, sealed, familiar, hush - the person's own switches; always count these\nwords_suggest | repeat - the page's word match on the description and the kind of place, a hint that can be wrong\nbusy_words | no\ncue_ids | passing = built for passing through or waiting; crowd = built for a crowd that is not there; empty = nobody else around; light = flat or buzzing artificial light; repeat = repeating doors, tiles or rows; sealed = no windows or no clock; familiar = feels familiar from childhood; hush = a hum, an echo or a hush\nverdict_rule | check in order and stop at the first that fits: 1) just_a_place when neither passing nor crowd is counted; 2) deeply_liminal when passing or crowd is counted AND empty is counted AND at least one of light, repeat, sealed, familiar, hush is counted; 3) otherwise at_the_right_hour\npage_verdict | deeply_liminal (from the ticked switches alone)"
}

{
 "task": "read",
 "title": "The Last Lap, All to Yourself",
 "cues_counted": [
  "crowd",
  "empty",
  "light",
  "repeat",
  "sealed",
  "familiar",
  "hush"
 ],
 "verdict": "deeply_liminal",
 "verdict_reason": "It's built for a crowd that isn't there, with nobody else around, rows of empty benches, no windows, a familiar smell and only a hum for company.",
 "reading": "A pool like this is built for a crowd that isn't there, but during the last swim before closing, you have the benches and the still water entirely to yourself.",
 "signs": [
  {
   "cue": "empty",
   "seen": "You say you're usually the only one left for the last lane swim before closing."
  },
  {
   "cue": "sealed",
   "seen": "No windows at all, exactly as you described it."
  },
  {
   "cue": "hush",
   "seen": "The only sound is the filter humming, you said."
  },
  {
   "cue": "familiar",
   "seen": "That chlorine smell takes you back to school swimming lessons."
  }
 ],
 "best_hours": {
  "when": "late",
  "why": "The last lane swim before closing already leaves you alone with rows of empty benches and a humming filter."
 },
 "tip_more": "Pause by the still water and listen to the filter humming before you leave.",
 "visit_note": "Stay only while it's open to you, keep exits and doors clear, and leave right away if asked."
}

{
 "task": "read",
 "place": "The ticket hall at our main train station around six in the evening. Crowds stream past the long row of ticket machines, the departure boards keep flipping, and there's always a queue at the coffee kiosk. Big glass roof overhead.",
 "kind": "concourse",
 "when": "evening",
 "cues": "passing, repeat",
 "page_facts": "kind | a station or terminal concourse\nwhen | evening\nticked | passing, repeat - the person's own switches; always count these\nwords_suggest | none - the page's word match on the description and the kind of place, a hint that can be wrong\nbusy_words | yes - the description mentions crowds or busyness\ncue_ids | passing = built for passing through or waiting; crowd = built for a crowd that is not there; empty = nobody else around; light = flat or buzzing artificial light; repeat = repeating doors, tiles or rows; sealed = no windows or no clock; familiar = feels familiar from childhood; hush = a hum, an echo or a hush\nverdict_rule | check in order and stop at the first that fits: 1) just_a_place when neither passing nor crowd is counted; 2) deeply_liminal when passing or crowd is counted AND empty is counted AND at least one of light, repeat, sealed, familiar, hush is counted; 3) otherwise at_the_right_hour\npage_verdict | at_the_right_hour (from the ticked switches alone)"
}

{
 "task": "read",
 "title": "Rows of Machines, Rivers of People",
 "cues_counted": [
  "passing",
  "repeat"
 ],
 "verdict": "at_the_right_hour",
 "verdict_reason": "Built for passing through and lined with repeating machines, it's in-between at the right hour - but the crowds keep it far from deserted, so it's not deeply in-between.",
 "reading": "This hall is built to move people through - and right now it's doing exactly that, streams of people cutting past repeating machines, the evening crowd filling it the way it's meant to be used.",
 "signs": [
  {
   "cue": "passing",
   "seen": "Crowds stream past the long row of ticket machines - everyone moving through, not stopping."
  },
  {
   "cue": "repeat",
   "seen": "The long row of ticket machines repeats again and again along the hall."
  }
 ],
 "best_hours": {
  "when": "late",
  "why": "Late, once the evening crowds thin and the ticket machines and departure boards sit mostly unused."
 },
 "tip_more": "Pause by the ticket machines a moment and watch the departure board flip while the crowd moves past you.",
 "visit_note": "Only linger if the hall is open to the public, keep ticket machines and exits clear, and move on if asked."
}

{
 "task": "read",
 "place": "Our neighbourhood cafe at lunchtime: regulars chatting at the counter, the radio on, big windows onto the street and the smell of toast. It looks almost exactly like the cafe my grandparents ran when I was small.",
 "kind": "other",
 "when": "midday",
 "cues": "familiar",
 "page_facts": "kind | somewhere else\nwhen | middle of the day\nticked | familiar - the person's own switches; always count these\nwords_suggest | none - the page's word match on the description and the kind of place, a hint that can be wrong\nbusy_words | yes - the description mentions crowds or busyness\ncue_ids | passing = built for passing through or waiting; crowd = built for a crowd that is not there; empty = nobody else around; light = flat or buzzing artificial light; repeat = repeating doors, tiles or rows; sealed = no windows or no clock; familiar = feels familiar from childhood; hush = a hum, an echo or a hush\nverdict_rule | check in order and stop at the first that fits: 1) just_a_place when neither passing nor crowd is counted; 2) deeply_liminal when passing or crowd is counted AND empty is counted AND at least one of light, repeat, sealed, familiar, hush is counted; 3) otherwise at_the_right_hour\npage_verdict | just_a_place (from the ticked switches alone)"
}

{
 "task": "read",
 "title": "A Cafe That Remembers Your Grandparents",
 "cues_counted": [
  "familiar"
 ],
 "verdict": "just_a_place",
 "verdict_reason": "This cafe isn't built for moving people through or for a gathering that isn't there - it simply carries a feeling from childhood.",
 "reading": "This cafe is built for people to settle in and meet - regulars at the counter, a radio playing, windows looking onto the street - which keeps it rooted in the everyday rather than in-between.",
 "signs": [
  {
   "cue": "familiar",
   "seen": "It looks almost exactly like the cafe your grandparents ran when you were small."
  }
 ],
 "best_hours": {
  "when": "early",
  "why": "Before the regulars settle in at lunchtime, the counter and windows may feel far quieter and less busy."
 },
 "tip_more": "Pause by the window, catch the radio under the chatter and the smell of toast, and notice how ordinary it feels.",
 "visit_note": "Stop by only when it's open to you, keep the entrance clear, and leave if asked."
}

const K = HallKit;
const built = K.buildInput({ place: "The corridor to the gym changing rooms at 6am: long, carpeted, nobody else about.", kind: "corridor", when: "early", cues: ["passing", "empty", "repeat"] });
built.pre;                                       // { ticked, hinted, suggested, busy, verdict, lamps } - the page's free reading
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 reading
// K.verdictFor(reply.cues_counted)              // the verdict rule on the reply's own cues

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

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

# input.json: the run input object - {"task": "read", "place": "...", "kind": "stairwell", "when": "early", "cues": "passing, empty, light", "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="between-hours:read:$(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: between-hours:read:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json