Drive Fold and Look from your own code

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

{"task": "read-blots", "verdict": "fresh-eye", "headline": "...", "blots": [{"n": 1, "kind": "own", "reading": "...", "second_look": "...?"}, ...], "thread": "...", "closing": "..."}

{
 "task": "read-blots",
 "answers": "blot 1 | the whole blot | a bat\nblot 2 | the whole blot | two people clapping hands\nblot 3 | the whole blot | a butterfly\nblot 4 | the whole blot | a crab\nblot 5 | the whole blot | a lighthouse in fog",
 "tally": "B1 | usual (bat) | whole | 2 words | second look: scale - change its size\nB2 | usual (people) | whole | 4 words, detailed | second look: who - change who or what it is\nB3 | usual (butterfly) | whole | 2 words | second look: when - change when it happens\nB4 | usual (crab) | whole | 2 words | second look: doing - change what it is doing\nB5 | own | whole | 4 words, detailed | second look: borrow - borrow it from a different world\nanswered 5 | usual 4 | own 1 | part 0 | whole 5 | detailed 2"
}

{
 "task": "read-blots",
 "verdict": "crowd-eye",
 "headline": "You mostly saw the same things many people see.",
 "blots": [
  {
   "n": 1,
   "kind": "usual",
   "reading": "You took in the whole blot and named a bat - many people land on this same answer.",
   "second_look": "What if that bat were a different size?"
  },
  {
   "n": 2,
   "kind": "usual",
   "reading": "Taking in the entire blot, you named 2 people clapping hands - many people arrive at this same notion.",
   "second_look": "What if those people were someone or something else?"
  },
  {
   "n": 3,
   "kind": "usual",
   "reading": "You saw the full blot as a butterfly - many people reach this same idea.",
   "second_look": "What if this butterfly appeared at a different time?"
  },
  {
   "n": 4,
   "kind": "usual",
   "reading": "You took in all of the blot and named a crab - many people share this same thought.",
   "second_look": "What if this crab were doing something else?"
  },
  {
   "n": 5,
   "kind": "own",
   "reading": "You saw the blot entirely as a lighthouse in fog - a take that is your own.",
   "second_look": "What if this lighthouse in fog belonged to a different world entirely?"
  }
 ],
 "thread": "Across 5 blots you named bat, people, butterfly and crab - 4 defaults to look past next - alongside your own lighthouse in fog.",
 "closing": "Most of what you named matches what many people spot - a fresh look could turn up something only yours."
}

{
 "task": "read-blots",
 "answers": "blot 1 | a part of the blot | a keyhole in the middle\nblot 2 | a part of the blot | a pair of boots at the bottom\nblot 3 | the whole blot | a bat\nblot 4 | a part of the blot | a little teapot spout on the left edge\nblot 5 | skipped",
 "tally": "B1 | own | part | 5 words, detailed | second look: scale - change its size\nB2 | own | part | 7 words, detailed | second look: who - change who or what it is\nB3 | usual (bat) | whole | 2 words | second look: when - change when it happens\nB4 | own | part | 8 words, detailed | second look: doing - change what it is doing\nB5 | skipped\nanswered 4 | usual 1 | own 3 | part 3 | whole 1 | detailed 3"
}

{
 "task": "read-blots",
 "verdict": "detail-hunter",
 "headline": "You mostly zoomed in on parts of these blots.",
 "blots": [
  {
   "n": 1,
   "kind": "own",
   "reading": "You zoomed into the middle and named a keyhole, a part only you picked out of the whole blot.",
   "second_look": "What different size might this keyhole be?"
  },
  {
   "n": 2,
   "kind": "own",
   "reading": "You looked to the bottom and named boots there, a close part that is yours alone.",
   "second_look": "Who or what else might these boots be?"
  },
  {
   "n": 3,
   "kind": "usual",
   "reading": "You took in the whole blot and saw a bat, something many people land on too, named simply and warmly.",
   "second_look": "What different time might this bat belong to?"
  },
  {
   "n": 4,
   "kind": "own",
   "reading": "You picked the left edge of this blot and named a little teapot spout - a precise detail only you reached for.",
   "second_look": "What might this teapot spout be doing instead?"
  }
 ],
 "thread": "You picked out 3 parts - a keyhole, boots, a teapot spout - across your 4 answers, taking in the whole blot only 1 time, for a bat.",
 "closing": "This set leans toward parts over the whole blot - worth a second look at what else those pieces could be."
}

{
 "task": "read-blots",
 "answers": "blot 1 | the whole blot | a chandelier dripping wax onto a ballroom floor\nblot 2 | the whole blot | an accordion folding shut with a sigh\nblot 3 | the whole blot | a cathedral doorway seen from below\nblot 4 | the whole blot | a moth\nblot 5 | the whole blot | a tired knight leaning on a shield",
 "tally": "B1 | own | whole | 8 words, detailed | second look: scale - change its size\nB2 | own | whole | 7 words, detailed | second look: who - change who or what it is\nB3 | own | whole | 6 words, detailed | second look: when - change when it happens\nB4 | usual (moth) | whole | 2 words | second look: doing - change what it is doing\nB5 | own | whole | 7 words, detailed | second look: borrow - borrow it from a different world\nanswered 5 | usual 1 | own 4 | part 0 | whole 5 | detailed 4"
}

{
 "task": "read-blots",
 "verdict": "far-eye",
 "headline": "Most of your answers were your own, written out in detail.",
 "blots": [
  {
   "n": 1,
   "kind": "own",
   "reading": "You took in the whole blot and named a chandelier dripping wax onto a ballroom floor - a vivid picture, fully your own.",
   "second_look": "If that chandelier were far smaller, what would you notice about the wax and the floor?"
  },
  {
   "n": 2,
   "kind": "own",
   "reading": "You saw the whole blot as an accordion folding shut with a sigh - an image that's entirely yours.",
   "second_look": "If something other than an accordion were folding shut with a sigh, what might it be?"
  },
  {
   "n": 3,
   "kind": "own",
   "reading": "You took in the whole shape and saw a cathedral doorway seen from below - your own view, imagined in detail.",
   "second_look": "If this cathedral doorway appeared at another time, what might look different?"
  },
  {
   "n": 4,
   "kind": "usual",
   "reading": "You saw all of it as a moth. Many people land on that same picture too - a fine, simple thing to notice.",
   "second_look": "That moth - what might it be doing right now?"
  },
  {
   "n": 5,
   "kind": "own",
   "reading": "You saw the whole image as a tired knight leaning on a shield - a detailed scene fully your own.",
   "second_look": "That knight - if it belonged to a different world, what might change about it?"
  }
 ],
 "thread": "You answered all 5 blots, 4 in your own words and 4 with detail - a chandelier, an accordion, a cathedral doorway, a moth, and a knight, each read your way.",
 "closing": "These 5 answers were mostly your own and detailed - worth a closer second look at each blot."
}

{
 "task": "read-blots",
 "answers": "blot 1 | the whole blot | a teapot\nblot 2 | the whole blot | an anchor\nblot 3 | the whole blot | a spider\nblot 4 | the whole blot | a jellyfish\nblot 5 | a part of the blot | a bow tie",
 "tally": "B1 | own | whole | 2 words | second look: scale - change its size\nB2 | own | whole | 2 words | second look: who - change who or what it is\nB3 | usual (spider) | whole | 2 words | second look: when - change when it happens\nB4 | own | whole | 2 words | second look: doing - change what it is doing\nB5 | own | part | 3 words | second look: borrow - borrow it from a different world\nanswered 5 | usual 1 | own 4 | part 1 | whole 4 | detailed 0"
}

{
 "task": "read-blots",
 "verdict": "fresh-eye",
 "headline": "Most of your answers were your own, not borrowed ones.",
 "blots": [
  {
   "n": 1,
   "kind": "own",
   "reading": "You took in the whole blot and named a teapot, a reading entirely your own.",
   "second_look": "If that teapot were far smaller, what would you call it?"
  },
  {
   "n": 2,
   "kind": "own",
   "reading": "You took in the whole blot and called it an anchor, a choice entirely your own.",
   "second_look": "If that anchor were someone or something entirely different, who or what might it be?"
  },
  {
   "n": 3,
   "kind": "usual",
   "reading": "Taking the blot as a whole, you saw a spider, the same thing plenty of people notice too - good company.",
   "second_look": "If that spider were from a different time, when would it be?"
  },
  {
   "n": 4,
   "kind": "own",
   "reading": "You looked at the full shape and named a jellyfish, a pick that's yours alone.",
   "second_look": "If that jellyfish were doing something else entirely, what might it be doing?"
  },
  {
   "n": 5,
   "kind": "own",
   "reading": "You zoomed in on a part of the blot and saw a bow tie, a detail that's all yours.",
   "second_look": "If that bow tie came from a completely different world, what might it be there?"
  }
 ],
 "thread": "You brought 4 of your 5 answers in your own words - a teapot, an anchor, a jellyfish and a bow tie, alongside a spider - mostly taking in the whole blot, with just a part for the bow tie.",
 "closing": "Most of what you saw was your own - take another look and see what else these blots might hold."
}

const K = BlotKit;
const built = K.buildInput(K.form({ seed: 7, answers: [
  { text: "a kite caught in a tree", where: "whole" }, { text: "a comb", where: "part" },
  { text: "a tuba" }, { text: "" }, { text: "two foxes arguing" } ] }));
built.input.tally;                      // the page's 5 tally lines + the counts line
const wire = K.toWire(built.input);     // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// built.facts.verdict                  // the verdict the page's rule gives
// K.check(reply, built).notes          // the page's re-check of the reply
// K.md(built, reply, "my set")         // the set as Markdown

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

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

# input.json: the run input object - {"task": "read-blots", "answers": "blot 1 | the whole blot | a bat
...", "tally": "B1 | usual (bat) | whole | 2 words | second look: scale - change its size
..."}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="fold-and-look:read-blots:$(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: fold-and-look:read-blots:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json