Drive Red String from your own code

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

{
 "task": "audit",
 "title": "The Greenhouse Will",
 "premise": "A wealthy old man is found dead in his greenhouse the morning after rewriting his will. Snowed-in country house, four people inside, a retired schoolteacher as the detective. The doctor poisoned him with his own heart pills to stop him reporting the prescriptions she had been forging.",
 "chapters": 24,
 "reveal": 22,
 "culprit": "S3 Dr Ines Hale",
 "suspects": "S1 | Margaret Ashby | the widow | motive: the new will leaves her nothing | first appears ch 1 | innocent\nS2 | Tom Ashby | the nephew, deep in debt | motive: inherits the estate | first appears ch 2 | innocent\n... 2 more lines",
 "clues": "C1 | ch 3 | Hale arrives saying she walked from the surgery, but her shoes are dry after the downpour | points at S3 | on the page\nC2 | ch 5 | Betting slips in the study wastepaper basket | points at S2 | on the page\n... 6 more lines",
 "facts": "[{\"id\": \"F-case\", \"text\": \"24 chapters; the detective names the culprit in chapter 22; 4 suspects, 8 clues.\"}, {\"id\": \"F-culprit\", \"text\": \"The culprit is S3 Dr Ines Hale, first on stage in chapter 1 - inside the first third (by chapter 8).\"}, {\"id\": \"F-S1\", \"text\": \"S1 Margaret Ashby: first appears in chapter 1; 1 on-page clue before the reveal points at them; motive: the new will leaves her nothing.\"}, \"... 13 more facts\"]"
}

{
 "task": "audit",
 "verdict": "fair",
 "verdict_why": "Three separate on-page facts really implicate Hale before chapter 22 - the dry shoes, the missing prescription sheets, and her unprompted knowledge of the crushed pills - and she has been on stage since chapter 1, with nothing the solution needs held off the page. The five red herrings spread suspicion onto Tom, Margaret and Petra by ordinary, innocent-looking means, and no single suspect runs away with the clue count, so the case is close without being hidden.",
 "title": "The Greenhouse Will",
 "reader_guess": {
  "id": "S3",
  "why": "By chapter 15 Hale has lied about her alibi, is missing prescription sheets, and names a detail of the poisoning she was never told; Tom's betting slips, the stray key and his midnight lie make him a close second, but none of his clues actually prove involvement.",
  "cite": [
   "F-C1",
   "F-C4",
   "F-C6",
   "F-S2",
   "F-obvious"
  ]
 },
 "suspects": [
  {
   "id": "S1",
   "suspicion": 2,
   "note": "Margaret has a clear motive and one suspicious on-page act, but burning letters never ties her to the poisoning itself.",
   "cite": [
    "F-S1",
    "F-C5"
   ]
  },
  {
   "id": "S2",
   "suspicion": 4,
   "note": "Tom has a strong financial motive and three on-page clues - the betting slips, Petra's key in his pocket and his midnight lie - that stack up to make him look like the obvious culprit.",
   "cite": [
    "F-S2",
    "F-C2",
    "F-C7",
    "F-C8"
   ]
  },
  "... 2 more"
 ],
 "clues": [
  {
   "id": "C1",
   "strength": "strong",
   "note": "Hale claims she walked through the downpour, but dry shoes prove that story false, and a doctor caught lying about her whereabouts is a direct mark against her.",
   "cite": [
    "F-C1"
   ]
  },
  {
   "id": "C2",
   "strength": "weak",
   "note": "Betting slips confirm the money troubles the reader already knows about, but discarded slips don't place Tom at the greenhouse or prove he acted.",
   "cite": [
    "F-C2"
   ]
  },
  "... 6 more"
 ],
 "plants": [],
 "tips": [
  "Plant physical contradictions like the dry shoes early and let the detective simply note them on the page without comment, so a sharp reader can do the deduction ahead of the reveal.",
  "Give every red herring an honest, human reason once it resolves - a debt, an embarrassment, a private errand - so the reader feels misled fairly rather than cheated.",
  "... 2 more"
 ]
}

{
 "task": "audit",
 "title": "Last Ferry Out",
 "premise": "A storm crossing on the last ferry of the season. A businessman goes over the rail in the night and the island constable, who happens to be aboard, has until landfall. The purser pushed him after the businessman found the skimmed fares.",
 "chapters": 20,
 "reveal": 19,
 "culprit": "S4 Felix Grey",
 "suspects": "S1 | Captain Ruth Okafor | the ferry captain | motive: the victim was going to report her drinking | first appears ch 1 | innocent\nS2 | Leo Marsh | the victim's business partner | motive: the partnership insurance | first appears ch 2 | innocent\n... 2 more lines",
 "clues": "C1 | ch 3 | An empty bottle rolls out from under the wheelhouse chart table | points at S1 | on the page\nC2 | ch 6 | Leo phones the insurer the morning after the crossing | points at S2 | on the page\n... 3 more lines",
 "facts": "[{\"id\": \"F-case\", \"text\": \"20 chapters; the detective names the culprit in chapter 19; 4 suspects, 5 clues.\"}, {\"id\": \"F-culprit\", \"text\": \"The culprit is S4 Felix Grey, first on stage in chapter 11 - after the first third (rule of thumb: by chapter 7).\"}, {\"id\": \"F-S1\", \"text\": \"S1 Captain Ruth Okafor: first appears in chapter 1; 2 on-page clues before the reveal point at them; motive: the victim was going to report her drinking.\"}, \"... 12 more facts\"]"
}

{
 "task": "audit",
 "verdict": "thin",
 "verdict_why": "Felix only comes on stage in chapter 11, after the first third, and both clues that truly implicate him land in chapters 16 and 17, the last quarter before the reveal; meanwhile Anya has no on-page clue at all, so one suspect sits on the board with nothing for the reader to weigh.",
 "title": "Last Ferry Out",
 "reader_guess": {
  "id": "S4",
  "why": "The till shortfall matching the victim's notebook and the soaked jacket contradicting his own denial are stronger, harder-to-explain-away evidence than Ruth's missing minutes or Leo's insurance call, so a careful reader points to Felix.",
  "cite": [
   "F-S4",
   "F-C4",
   "F-C5",
   "F-obvious"
  ]
 },
 "suspects": [
  {
   "id": "S1",
   "suspicion": 3,
   "note": "An empty bottle that rolled out from under the chart table and twenty minutes she can't account for give Ruth both opportunity and a motive to silence the victim, even though neither clue shows her at the rail.",
   "cite": [
    "F-S1",
    "F-C1",
    "F-C3"
   ]
  },
  {
   "id": "S2",
   "suspicion": 2,
   "note": "Leo's call to the insurer the morning after fits his insurance motive, but it is exactly what an innocent partner would also do, so it raises motive more than suspicion.",
   "cite": [
    "F-S2",
    "F-C2"
   ]
  },
  "... 2 more"
 ],
 "clues": [
  {
   "id": "C1",
   "strength": "weak",
   "note": "An empty bottle under the chart table points to Ruth's drinking, which fits her motive, but it does not put her at the rail when the victim went over.",
   "cite": [
    "F-C1"
   ]
  },
  {
   "id": "C2",
   "strength": "weak",
   "note": "A phone call to the insurer the next morning fits Leo's insurance motive, but routine business behavior does not prove murder.",
   "cite": [
    "F-C2"
   ]
  },
  "... 3 more"
 ],
 "plants": [
  {
   "chapter": 5,
   "points": "S4",
   "text": "Felix is shown going over the till roll and pauses on a figure that does not match, before quickly moving on.",
   "why": "Puts the culprit on stage inside the first third and gives the reader an early, quiet reason to watch him instead of meeting him for the first time in chapter 11.",
   "cite": [
    "F-culprit",
    "F-crammed"
   ]
  },
  {
   "chapter": 10,
   "points": "S4",
   "text": "During the storm, Felix is seen out on deck near the rail, though he later tells the captain he never went out there.",
   "why": "Moves a second Felix clue into the book's middle third and plants the lie earlier, so the case against him isn't assembled entirely in the last quarter.",
   "cite": [
    "F-crammed",
    "F-earnable"
   ]
  },
  "... 2 more"
 ],
 "tips": [
  "Give the culprit a real scene within the book's first third so the reader has watched him before suspecting him.",
  "Move at least one of the clues that implicates the culprit into the book's middle third, so the case doesn't land all at once near the reveal.",
  "... 2 more"
 ],
 "caveats": [
  "Anya's motive is listed as none; a new clue alone won't make her feel like a real suspect without also giving her a reason to want the victim gone."
 ]
}

{
 "task": "audit",
 "title": "The Lantern Walk",
 "premise": "Halloween night in a small village: the annual lantern walk, a body by the stile, a retired police sergeant who runs the tea room. The schoolteacher killed the blackmailer and slipped back into the children's procession.",
 "chapters": 18,
 "reveal": 17,
 "culprit": "S4 Bea Lowell",
 "suspects": "S1 | Reverend Alan Pike | organises the village lantern walk | motive: the victim was selling the church field | first appears ch 1 | innocent\nS2 | June Carrow | the victim's sister | motive: their mother's house | first appears ch 1 | innocent\n... 2 more lines",
 "clues": "C1 | ch 4 | Pike argued with the victim at the parish meeting | points at S1 | on the page\nC2 | ch 7 | June's lantern is found by the stile where the body lay | points at S2 | on the page\n... 4 more lines",
 "facts": "[{\"id\": \"F-case\", \"text\": \"18 chapters; the detective names the culprit in chapter 17; 4 suspects, 6 clues.\"}, {\"id\": \"F-culprit\", \"text\": \"The culprit is S4 Bea Lowell, first on stage in chapter 2 - inside the first third (by chapter 6).\"}, {\"id\": \"F-S1\", \"text\": \"S1 Reverend Alan Pike: first appears in chapter 1; 2 on-page clues before the reveal point at them; motive: the victim was selling the church field.\"}, \"... 11 more facts\"]"
}

{
 "task": "audit",
 "verdict": "cheats",
 "verdict_why": "No earnable clue points at the culprit: the glove that would implicate Bea Lowell is kept off the page in chapter 10, and the one on-page clue against her, her lantern route past the stile, is withheld until chapter 17, the reveal chapter itself, so a careful reader cannot beat the detective to the answer.",
 "title": "The Lantern Walk",
 "reader_guess": {
  "id": "S1",
  "why": "Pike collects two on-page clues before the reveal, an argument with the victim over the church field and a lie about locking the church, more than any other suspect, so a careful reader would name him first.",
  "cite": [
   "F-S1",
   "F-C1",
   "F-C5",
   "F-obvious"
  ]
 },
 "suspects": [
  {
   "id": "S1",
   "suspicion": 4,
   "note": "Two on-page clues point at him, including a lie about his own timeline, making him look like the prime suspect to a careful reader.",
   "cite": [
    "F-S1",
    "F-C1",
    "F-C5"
   ]
  },
  {
   "id": "S2",
   "suspicion": 2,
   "note": "Her lantern turning up at the stile is suggestive, but it could just as easily have been dropped during the village's own lantern walk, so it only mildly raises suspicion.",
   "cite": [
    "F-S2",
    "F-C2"
   ]
  },
  "... 2 more"
 ],
 "clues": [
  {
   "id": "C1",
   "strength": "weak",
   "note": "A public argument about selling the church field shows motive, but it is ordinary village friction, not evidence of murder.",
   "cite": [
    "F-C1"
   ]
  },
  {
   "id": "C2",
   "strength": "weak",
   "note": "A lantern by the stile could simply have been dropped during the walk the whole village takes that night, so it only loosely ties June to the body.",
   "cite": [
    "F-C2"
   ]
  },
  "... 4 more"
 ],
 "plants": [
  {
   "chapter": 10,
   "points": "S4",
   "text": "The reader sees what the detective sees on the glove in the schoolroom: a smear of candle wax from a guttering lantern, the kind the children's lanterns use, on Bea's own spare glove.",
   "why": "Turns the only clue naming Bea into one the reader can weigh before the reveal, giving the book its first earnable clue against the culprit.",
   "cite": [
    "F-C3",
    "F-earnable"
   ]
  },
  {
   "chapter": 9,
   "points": "S4",
   "text": "The reader sees Bea's lantern walk route sheet pinned up in the schoolroom, already marked to pass the stile at nine, the same route the detective reads aloud in chapter 17.",
   "why": "Moves the clue that currently only appears in the reveal chapter onto the page early enough for the reader to use it, giving a second earnable clue against the culprit.",
   "cite": [
    "F-C6",
    "F-earnable"
   ]
  },
  "... 1 more"
 ],
 "tips": [
  "Show the glove's full detail on the page the moment the detective sees it, not only after the reveal, since fair play means letting the reader see what the detective sees.",
  "Give the culprit an on-page clue well before the final chapters, so she isn't only a name with a motive until the last pages.",
  "... 2 more"
 ],
 "caveats": [
  "This audit judges only the clue lines and summaries given, not any fuller manuscript text."
 ]
}

const K = CaseKit;
const { kase } = K.parseCase([
  "Chapters: 20", "Reveal: 19",
  "Suspect: Ruth | the captain | ch 1", "Suspect: Felix | the purser | ch 11 | culprit",
  "Clue: ch 16 | The till roll is short | -> Felix"
].join("\n"));
const { input } = K.buildInput(kase);
const wire = K.toWire(input);        // POST this to /estimate and /run
// later: const n = K.normalize(K.parseReply(job.output.output));
// const { notes, pinnable } = K.checkReview(n, kase);  K.applyPlants(kase, n).kase -> the board with the plants pinned

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

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

# input.json: the run input object - {"task": "audit", "title": "...", "premise": "...", "chapters": 20, "reveal": 19, "culprit": "S4 Felix Grey", "suspects": "S1 | ...", "clues": "C1 | ch 3 | ...", "facts": "[...]"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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