Drive Type Case from your own code

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

{
 "task": "pair",
 "piece": "Menu card for a weekend bakery stall",
 "venue": "print",
 "mood": "warm, handmade, a little old-fashioned",
 "headline": "Saturday Bakes",
 "sample": "Cardamom buns, rye sourdough and a plum galette. Everything is baked the night before and sold until it runs out.",
 "avoid": "nothing that looks like a supermarket",
 "body_floor": "12",
 "thin_brief": "no"
}

{
 "task": "pair",
 "verdict": "pairs",
 "title": "A Warm, Handmade Weekend Bakery Menu",
 "summary": "All three pairs stay warm and handmade, keep the body text at a comfortable size for a card held in the hand, and avoid anything that reads as a supermarket. The safe pair leans on an old-fashioned serif heading over a bookish body text, the character pair swaps in a handwritten heading over a characterful grotesque for a more personal touch, and the wild-card pair goes bigger and more playful with a retro display heading set against a plain, neutral body.",
 "pairs": [
  {
   "id": "P1",
   "label": "safe",
   "heading": "young-serif",
   "heading_weight": "400",
   "body": "literata",
   "body_weight": "400",
   "heading_px": "30",
   "body_px": "13",
   "why": "Young Serif is built to feel warm and a little old-fashioned, which matches the mood directly, and Literata stays sturdy and bookish at small sizes so the list of bakes stays easy to read on a card held in the hand, never drifting toward a supermarket look.",
   "watch": "Young Serif only comes in one weight, so there is no bolder cut to lean on if part of the headline needs more punch."
  },
  {
   "id": "P2",
   "label": "character",
   "heading": "caveat",
   "heading_weight": "700",
   "body": "bricolage",
   "body_weight": "400",
   "heading_px": "38",
   "body_px": "13",
   "why": "Caveat brings a handwritten, personal touch that matches the handmade mood, and Bricolage Grotesque is a quirky but readable grotesque that keeps the longer lines about the bakes legible while still feeling characterful rather than generic.",
   "watch": "Caveat suits short bits like labels, so keep it to the headline and do not stretch it across the longer lines about the bakes."
  },
  "... (3 in all)"
 ],
 "asks": []
}

{
 "task": "pair",
 "piece": "Landing page for a neighbourhood tool library",
 "venue": "screen",
 "mood": "practical, friendly, trustworthy",
 "headline": "Borrow the drill. Skip the store.",
 "sample": "Members borrow ladders, saws and sanders for a week at a time. Join with a library card and a short safety talk.",
 "avoid": "nothing that looks like a bank",
 "body_floor": "16",
 "thin_brief": "no"
}

{
 "task": "pair",
 "verdict": "pairs",
 "title": "A Practical, Trustworthy Library Landing Page",
 "summary": "All three pairings pick up the brief's own words practical, friendly and trustworthy, keep the body face plain and easy to read on a screen, and stay well away from anything that could look like a bank. The safe pairing leans on a sturdy, workmanlike heading over a quiet, neutral body; the character pairing adds a characterful, ink-trapped heading over a bookish body that echoes the word library; and the wild-card pairing brings in a wide, arty heading over a plain-spoken body for more energy without losing trust.",
 "pairs": [
  {
   "id": "P1",
   "label": "safe",
   "heading": "zilla-slab",
   "heading_weight": "700",
   "body": "hanken",
   "body_weight": "400",
   "heading_px": "28",
   "body_px": "16",
   "why": "This stays close to the brief's own feel: Zilla Slab's sturdy, workmanlike character suits a tool library, and Hanken Grotesk is a quiet, neutral workhorse that keeps the body plain and trustworthy on a screen.",
   "watch": "Watch that the slab's bold weight does not get set any heavier or larger than this, since that can tip the sturdy feel into something heavy rather than friendly."
  },
  {
   "id": "P2",
   "label": "character",
   "heading": "bricolage",
   "heading_weight": "700",
   "body": "literata",
   "body_weight": "400",
   "heading_px": "34",
   "body_px": "17",
   "why": "This brings in more personality while staying friendly: Bricolage Grotesque's ink-trapped character gives the heading some warmth, and Literata's bookish, sturdy-at-small-sizes feel nods to the brief's own library without losing trust.",
   "watch": "Watch that Bricolage Grotesque's ink traps do not get muddy if the heading is set smaller than this, since the quirks need room to stay legible."
  },
  "... (3 in all)"
 ],
 "asks": []
}

{
 "task": "pair",
 "piece": "A poster",
 "venue": "wall",
 "mood": "",
 "headline": "Open Day",
 "sample": "",
 "avoid": "",
 "body_floor": "24",
 "thin_brief": "yes"
}

{
 "task": "pair",
 "verdict": "ask-first",
 "title": "A Poster for Open Day",
 "summary": "The brief names the piece and its headline but leaves the feel and anything to avoid unsaid, so pairing now would mean guessing. A few short answers will let the heading and body faces truly suit this poster before it goes up on the wall.",
 "pairs": [],
 "asks": [
  "Who will be reading this poster?",
  "What feeling should it have?",
  "Is there a look the poster should avoid?"
 ]
}

{
 "task": "check",
 "piece": "Landing page for a neighbourhood tool library",
 "venue": "screen",
 "mood": "practical, friendly, trustworthy",
 "headline": "Borrow the drill. Skip the store.",
 "sample": "Members borrow ladders, saws and sanders for a week at a time. Join with a library card and a short safety talk.",
 "avoid": "nothing that looks like a bank",
 "body_floor": "16",
 "heading_font": "bricolage",
 "heading_weight": "700",
 "body_font": "atkinson",
 "body_weight": "400",
 "heading_px": "44",
 "body_px": "18"
}

{
 "task": "check",
 "verdict": "keep",
 "title": "Bricolage Grotesque Over Atkinson Hyperlegible",
 "summary": "This pair can stay as set: the heading face is characterful but readable, and the body face is plain-spoken with every letter distinct, matching the practical, friendly and trustworthy feel asked for, with nothing that looks like a bank. The body size already sits above the smallest comfortable body size, and the heading is comfortably larger than the safe minimum, so the scale reads clearly on screen.",
 "issues": [],
 "fix": {
  "heading": "",
  "heading_weight": "",
  "body": "",
  "body_weight": "",
  "heading_px": "",
  "body_px": ""
 },
 "works": "The characterful heading stays readable, and the plain-spoken body face keeps every word of the sample clear and trustworthy."
}

{
 "task": "check",
 "piece": "Menu card for a weekend bakery stall",
 "venue": "print",
 "mood": "warm, handmade, a little old-fashioned",
 "headline": "Saturday Bakes",
 "sample": "Cardamom buns, rye sourdough and a plum galette. Everything is baked the night before and sold until it runs out.",
 "avoid": "nothing that looks like a supermarket",
 "body_floor": "12",
 "heading_font": "young-serif",
 "heading_weight": "400",
 "body_font": "literata",
 "body_weight": "400",
 "heading_px": "13",
 "body_px": "11"
}

{
 "task": "check",
 "verdict": "tweak",
 "title": "Young Serif Over Literata",
 "summary": "This is a tweak: the faces already suit the warm, old-fashioned mood, but the sizes do not yet hold up in print. The body size sits under the smallest comfortable size for this piece, and the heading does not clear the safe scale over the body, so the two text sizes read too close together.",
 "issues": [
  {
   "rule": "too-small",
   "note": "The body size of 11 falls below the smallest comfortable body size of 12 for this piece."
  },
  {
   "rule": "flat-scale",
   "note": "The heading size of 13 over the body size of 11 comes out under the 1.25 minimum, so heading and body sit too close in scale."
  }
 ],
 "fix": {
  "heading": "young-serif",
  "heading_weight": "400",
  "body": "literata",
  "body_weight": "400",
  "heading_px": "15",
  "body_px": "12"
 },
 "works": "Young Serif's warm, old-fashioned feel over Literata's sturdy small-size reading keeps the bakery mood intact, and the fix holds both faces exactly as set."
}

{
 "task": "check",
 "piece": "Landing page for a neighbourhood tool library",
 "venue": "screen",
 "mood": "practical, friendly, trustworthy",
 "headline": "Borrow the drill. Skip the store.",
 "sample": "Members borrow ladders, saws and sanders for a week at a time. Join with a library card and a short safety talk.",
 "avoid": "nothing that looks like a bank",
 "body_floor": "16",
 "heading_font": "abril-fatface",
 "heading_weight": "400",
 "body_font": "caveat",
 "body_weight": "400",
 "heading_px": "48",
 "body_px": "18"
}

{
 "task": "check",
 "verdict": "swap",
 "title": "Abril Fatface Over Caveat",
 "summary": "This pairing calls for a swap: the body is set in a handwritten display face, and a face like that is never meant to carry running text such as the sample about borrowing ladders, saws and sanders. Setting the body in a steady text face instead keeps the page feeling practical and trustworthy, while the bold heading still carries the short headline with plenty of presence for a screen read.",
 "issues": [
  {
   "rule": "display-body",
   "note": "The body face is a handwritten display face marked for display only, not for running text, so it will not hold up as body copy for the sample's full sentences."
  }
 ],
 "fix": {
  "heading": "abril-fatface",
  "heading_weight": "400",
  "body": "hanken",
  "body_weight": "400",
  "heading_px": "48",
  "body_px": "18"
 },
 "works": "The heading's bold, high-contrast scale already gives the short headline strong presence, and its size clears the smallest comfortable body size by a wide margin, so the fix keeps the heading exactly as set."
}

const K = TypeKit;
const form = K.form({ piece: "Menu card for a weekend bakery stall", venue: "print", mood: "warm, handmade",
  headline: "Saturday Bakes", sample: "Cardamom buns and rye sourdough.", avoid: "",
  heading_font: "young-serif", heading_weight: "400", body_font: "literata", body_weight: "400", heading_px: "30", body_px: "13" });
console.log(K.flags("check", form), K.leanCheck(form), K.stick(form).ratio);  // the proof marks, the page's lean, the scale
const wire = K.toWire(K.buildInput("pair", form).input);                     // POST this to /estimate and /run ("check" adds the stick)
// then: const reply = K.normalize(K.parseReply(job.output.output), "pair");
// const { notes } = K.check(reply, form);                                    // the page's re-check of the reply
// console.log(K.cssOf(reply.pairs[0]));                                      // CSS for the safe pair

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

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

# input.json: the run input object - {"task": "pair", "piece": "Menu card for a weekend bakery stall", "venue": "print", "mood": "warm, handmade, a little old-fashioned", "headline": "Saturday Bakes", "sample": "Cardamom buns, rye sourdough and a plum  ...", "body_floor": "12", "thin_brief": "no"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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