Drive Liner Clues from your own code

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

{
 "task": "deck",
 "level": "casual",
 "crowd": "three generations, ages 9 to 82",
 "artists": "[{\"n\":1,\"name\":\"Louis Armstrong\",\"notes\":\"gravelly singing voice; trumpet solos; New Orleans jazz\",\"note_traits\":3},{\"n\":2,\"name\":\"ABBA\",\"notes\":\"\",\"note_traits\":0},{\"n\":3,\"name\":\"Daft Punk\",\"notes\":\"robot helmets; vocoder vocals; French house\",\"note_traits\":3 ... (333 characters)",
 "page_flags": "[{\"level\":\"info\",\"text\":\"\\\"ABBA\\\" is a single word with no notes - if more than one act goes by it, add a note (\\\"the 90s rock band\\\") so the clues hit the righ ... (169 characters)"
}

{
 "task": "deck",
 "title": "Three-Generation Family Record Round",
 "summary": "All four rounds are ready for tonight - skim the host-check line on each one before you start so you catch anything worth double-checking.",
 "rounds": [
  {
   "n": 1,
   "name": "Louis Armstrong",
   "status": "ready",
   "dna": "A warm, gravel-edged voice trades lines with virtuoso brass over bright, major-key horn harmonies, all captured in the close, softly hissy warmth of an early studio while a bouncy, strutting rhythm carries the beat underneath.",
   "clues": [
    {
     "rung": 1,
     "dimension": "production",
     "text": "The recording has a warm, boxed-in closeness, as if the whole band gathered around a single microphone, with a soft hiss humming under every note.",
     "source": "general"
    },
    {
     "rung": 2,
     "dimension": "harmony",
     "text": "Horns stack into bright, cheerful major-key harmonies that trade short phrases back and forth like a friendly conversation.",
     "source": "general"
    },
    "..."
   ],
   "prompt_elements": [
    "gravelly, scat-singing voice",
    "soaring trumpet solos",
    "bright major-key horn harmony",
    "..."
   ],
   "host_check": "Check rung 1's claim about the single-microphone recording setup before reading it out.",
   "ask": ""
  },
  {
   "n": 2,
   "name": "ABBA",
   "status": "ready",
   "dna": "A pair of richly layered female voices glide over glossy, string-and-synth production and bittersweet major-to-minor harmonies, all riding a polished, dance-ready pulse.",
   "clues": [
    {
     "rung": 1,
     "dimension": "production",
     "text": "Women's voices are multi-tracked into a thick, glossy stack of harmony, polished with a bright, layered studio sheen.",
     "source": "general"
    },
    {
     "rung": 2,
     "dimension": "harmony",
     "text": "Melodies ride on lush, major-to-minor chord shifts that turn bittersweet in the middle of an otherwise sunny tune.",
     "source": "general"
    },
    "..."
   ],
   "prompt_elements": [
    "multi-tracked female vocal harmony",
    "glossy, layered pop production",
    "bittersweet major-to-minor melodies",
    "..."
   ],
   "host_check": "Check rung 3's claim about the shimmering strings and synth flourishes before reading it out.",
   "ask": ""
  },
  {
   "n": 3,
   "name": "Daft Punk",
   "status": "ready",
   "dna": "Robotically vocoded vocals ride over a relentless four-on-the-floor dance pulse, filtered disco-funk basslines, and bright, buzzing synthesizer hooks, all polished with crisp, club-ready electronic production.",
   "clues": [
    {
     "rung": 1,
     "dimension": "production",
     "text": "Vocals are run through a thick, robotic vocoder, turning every lyric into a buzzing, machine-smooth hum.",
     "source": "general"
    },
    {
     "rung": 2,
     "dimension": "harmony",
     "text": "Chords loop in short, hypnotic funk-influenced vamps, repeating and subtly mutating rather than resolving to a big finish.",
     "source": "general"
    },
    "..."
   ],
   "prompt_elements": [
    "robotic vocoder vocals",
    "four-on-the-floor dance beat",
    "filtered disco-funk basslines",
    "..."
   ],
   "host_check": "Check rung 1's claim about the vocoder effect before reading it out.",
   "ask": ""
  },
  "... (1 more round)"
 ]
}

{
 "task": "deck",
 "level": "mixed",
 "crowd": "",
 "artists": "[{\"n\":1,\"name\":\"Fleetwood Mac\",\"notes\":\"\",\"note_traits\":0},{\"n\":2,\"name\":\"The Upstairs Neighbours\",\"notes\":\"our friends' band; banjo and a brass section; every song is about trains; recorded live in a church hall\",\"note_traits\":5},{\"n\":3,\"name\":\"Glasswing Para ... (346 characters)",
 "page_flags": "[{\"level\":\"info\",\"text\":\"\\\"Kraftwerk\\\" is a single word with no notes - if more than one act goes by it, add a note (\\\"the 90s rock band\\\") so the clues hit the ... (174 characters)"
}

{
 "task": "deck",
 "title": "Tonight's Guess-the-Artist Round",
 "summary": "Two rounds are ready to play, one is built entirely from your notes, and one still needs a couple of sound details before you can use it.",
 "rounds": [
  {
   "n": 1,
   "name": "Fleetwood Mac",
   "status": "ready",
   "dna": "A bright, fingerpicked guitar line and close three-part vocal harmony ride a steady, unhurried rock pulse, polished with a warm, glossy studio sheen.",
   "clues": [
    {
     "rung": 1,
     "dimension": "instruments",
     "text": "A bright, fingerpicked guitar line weaves delicate, intricate patterns rather than simply strumming chords, giving the sound a crisp, melodic backbone.",
     "source": "general"
    },
    {
     "rung": 2,
     "dimension": "harmony",
     "text": "Three voices stack into close, bittersweet harmony, trading lead lines between a man and two women.",
     "source": "general"
    },
    "..."
   ],
   "prompt_elements": [
    "fingerpicked melodic guitar",
    "close three-part vocal harmony",
    "steady unhurried rock groove",
    "..."
   ],
   "host_check": "Check rung 1's claim about the fingerpicked guitar line - it's truest of the band's most famous songs, so confirm it fits whichever songs get used tonight.",
   "ask": ""
  },
  {
   "n": 2,
   "name": "The Upstairs Neighbours",
   "status": "notes_only",
   "dna": "Banjo and brass carry a live, train-themed set recorded in a church hall.",
   "clues": [
    {
     "rung": 1,
     "dimension": "instruments",
     "text": "A banjo plucks away while a brass section punches in with bright horn hits.",
     "source": "notes"
    },
    {
     "rung": 2,
     "dimension": "production",
     "text": "The whole thing was recorded live in a church hall.",
     "source": "notes"
    },
    "..."
   ],
   "prompt_elements": [
    "banjo",
    "brass section",
    "live church hall recording",
    "..."
   ],
   "host_check": "",
   "ask": ""
  },
  {
   "n": 3,
   "name": "Glasswing Parade",
   "status": "need_notes",
   "dna": "",
   "clues": [],
   "prompt_elements": [],
   "host_check": "",
   "ask": "I don't know this act by name, so I can't tell which band you mean. Could you add two or three sound details - the instruments, the voice, the tempo or mood, or even a decade - or just note which band this is?"
  },
  "... (1 more round)"
 ]
}

{
 "task": "deck",
 "level": "nerd",
 "crowd": "record-shop staff after closing",
 "artists": "[{\"n\":1,\"name\":\"Radiohead\",\"notes\":\"\",\"note_traits\":0},{\"n\":2,\"name\":\"Nirvana\",\"notes\":\"\",\"note_traits\":0},{\"n\":3,\"name\":\"Talking Heads\",\"notes\":\"jittery funk guitars; big suits\",\"note_traits\":2},{\"n\":4,\"name\":\"Nina Simone\",\"notes\":\"\",\"note_traits\":0}]",
 "page_flags": "[{\"level\":\"info\",\"text\":\"\\\"Radiohead\\\" is a single word with no notes - if more than one act goes by it, add a note (\\\"the 90s rock band\\\") so the clues hit the ... (345 characters)"
}

{
 "task": "deck",
 "title": "After-Hours Record Shop Guessing Round",
 "summary": "Three rounds are ready to go as written; one needs a quick note from you before it can join the set.",
 "rounds": [
  {
   "n": 1,
   "name": "Radiohead",
   "status": "ready",
   "dna": "Shifting, often irregular rhythms support slowly drifting, unresolved harmonies, with a high, breathy voice woven through cold, occasionally glitch-edited production.",
   "clues": [
    {
     "rung": 1,
     "dimension": "production",
     "text": "Live drum takes get chopped and reassembled into jittery, non-human loops, then layered under warm synth pads.",
     "source": "general"
    },
    {
     "rung": 2,
     "dimension": "harmony",
     "text": "The chords drift through unresolved, almost modal shapes that rarely resolve to a simple major chord, keeping the mood suspended.",
     "source": "general"
    },
    "..."
   ],
   "prompt_elements": [
    "icy electronic textures",
    "falsetto vocal floating over layered guitars",
    "irregular, shifting time signatures",
    "..."
   ],
   "host_check": "Check rung 1's claim about chopped, reassembled drum loops - truer of the band's early-2000s material than its earlier guitar-driven records.",
   "ask": ""
  },
  {
   "n": 2,
   "name": "Nirvana",
   "status": "need_notes",
   "dna": "",
   "clues": [],
   "prompt_elements": [],
   "host_check": "",
   "ask": "More than one act has recorded under the name Nirvana, so I can't be sure which one you mean. Add two or three sound traits - the instruments, the voice, the tempo or mood, or the decade - or just a word that points to the right act."
  },
  {
   "n": 3,
   "name": "Talking Heads",
   "status": "ready",
   "dna": "Clipped, syncopated funk guitar and a nervy half-sung voice sit atop lean, tightly separated production, with polyrhythmic percussion pulling the harmony toward African-influenced grooves.",
   "clues": [
    {
     "rung": 1,
     "dimension": "production",
     "text": "Each instrument sits in its own narrow slice of the mix - a clipped guitar line, a rubbery bass and a tight hi-hat - interlocking like separate machine parts.",
     "source": "general"
    },
    {
     "rung": 2,
     "dimension": "rhythm",
     "text": "A clipped, stuttering guitar figure plays slightly behind the beat, locking into a tense, funk-derived groove that never fully relaxes.",
     "source": "general"
    },
    "..."
   ],
   "prompt_elements": [
    "jittery funk guitar stabs",
    "nervy, half-spoken vocals",
    "tight polyrhythmic percussion",
    "..."
   ],
   "host_check": "Check rung 4's claim about West African-influenced percussion - true mainly of the band's early-1980s records, less so its first two albums.",
   "ask": ""
  },
  "... (1 more round)"
 ]
}

const K = ClueKit;
const form = { artists: "Nina Simone\nOur cousin's ska band | trombone; fast offbeat guitar; songs about the bus",
  players: "Ann, Bo", level: "mixed", crowd: "" };
const st = K.state(form);                       // the cleaned list (st.artists) and its flags (st.flags)
const wire = K.toWire(K.buildInput(st).input);  // POST this to /estimate and /run
// then: const deck = K.normalize(K.parseReply(job.output.output));
// const { notes, byRound } = K.check(deck, st);
// play it: const g = K.newGame(st.players); K.award(g, 1, 0, 2) gives player 0 four points on round 1

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

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

# input.json: the run input object - {"task": "deck", "level": "casual", "crowd": "three generations, ages 9 to 82", "artists": "[{\"n\":1,\"name\":\"Louis Armstrong\", ...}]", "page_flags": "[...]"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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