Drive Dog-Eared from your own code

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

{
 "task": "menu",
 "book": "Frankenstein by Mary Shelley",
 "read_to": "chapter 16",
 "held_back": "1",
 "lines": "[{\"id\":\"L1\",\"who\":\"Priya\",\"kind\":\"take\",\"ref\":\"ch. 5\",\"text\":\"Victor runs from the creature the moment it opens its eyes (ch. 5) - he's the real monster here\"},{\"id\":\"L2\",\"who\":\"Tom\",\"kind\":\"take\",\"ref\":\"ch. 16\",\"text\":\"I don't buy that. The creature still kills William and nobody made him do it (ch. 16)\"},{\"id\":\"L3\",\"who\":\"Ines\",\"kind\":\"quote\",\"ref\":\"ch. 10\",\"text\":\"\\\"I was benevolent and good; misery made me a fien ... (1145 characters)"
}

{
 "task": "menu",
 "verdict": "full-table",
 "title": "Frankenstein: who is the real monster",
 "summary": "Tonight's table is full: the group sent in plenty to chew on, from who really deserves blame to what the creature decides about Satan and Adam. That's enough for three full courses, with room for a side question too. One line is waiting past chapter 16, so tonight stays spoiler-free.",
 "starter": {
  "question": "Why do you think Victor never gives him a name?",
  "lines": [
   "L7"
  ]
 },
 "mains": [
  {
   "id": "M1",
   "lines": [
    "L1",
    "L2"
   ],
   "dish": "The real monster",
   "claim": "Priya says Victor is the real monster for running from the creature the moment it opens its eyes; Tom answers that the creature still chose to kill William, and nobody made him do it.",
   "move": "clarify",
   "question": "What does calling Victor 'the real monster' really mean here?",
   "follow_ups": [
    "How does the creature's choice to kill William change who deserves to be called a monster?",
    "What would it mean for both Victor and the creature to share that name?"
   ]
  },
  {
   "id": "M2",
   "lines": [
    "L3",
    "L6"
   ],
   "dish": "Misery, guilt, or excuse",
   "claim": "Ines quotes the creature saying misery made him a fiend and asks whether that is true or an excuse; Tom says Victor knew the truth at Justine's trial and said nothing.",
   "move": "assumptions",
   "question": "What does the idea that misery can turn someone into a fiend take for granted?",
   "follow_ups": [
    "What does Victor's silence at the trial take for granted about what he owed Justine?",
    "How far could the excuse in Ines's quote stretch to cover Victor's silence too?"
   ]
  },
  "... (3 in all)"
 ],
 "side": {
  "question": "What is the strongest case that the creature, not Victor, is the one who chose to kill William?",
  "lines": [
   "L1",
   "L6"
  ]
 },
 "dessert": {
  "question": "After tonight's arguments about monsters, excuses, and Satan or Adam, what would you most want to ask the author?",
  "lines": []
 },
 "asks": []
}

{
 "task": "menu",
 "book": "The Great Gatsby",
 "read_to": "chapter 5",
 "held_back": "0",
 "lines": "[{\"id\":\"L1\",\"who\":\"Rosa\",\"kind\":\"question\",\"ref\":\"ch. 1\",\"text\":\"Gatsby reaching out toward the green light at the end of Daisy's dock (ch. 1) - romantic or creepy?\"},{\"id\":\"L2\",\"who\":\"Dev\",\"kind\":\"take\",\"ref\":\"ch. 3\",\"text\":\"Nick calls himself one of the few honest people he has ever known. I don't trust him at all (ch. 3)\"},{\"id\":\"L3\",\"who\":\"Rosa\",\"kind\":\"take\",\"ref\":\"ch. 5\",\"text\":\"The shirts scene made me cry and ... (684 characters)"
}

{
 "task": "menu",
 "verdict": "light-bite",
 "title": "Honesty, trust, and the green light",
 "summary": "Tonight's table turns on two threads: how to feel about reaching for the green light and the shirts scene, and whether Nick or the host can really be trusted. A handful of lines gave enough for two courses, so we're keeping it to a light bite rather than a full spread.",
 "starter": {
  "question": "What's one moment from the book so far that has stuck with you?",
  "lines": []
 },
 "mains": [
  {
   "id": "M1",
   "lines": [
    "L1",
    "L3"
   ],
   "dish": "Reactions to Gatsby",
   "claim": "Rosa wonders whether Gatsby reaching for the green light is romantic or creepy, and says the shirts scene brought tears they can't explain.",
   "move": "clarify",
   "question": "When you call reaching for the green light 'romantic' or 'creepy,' what exactly are you reacting to?",
   "follow_ups": [
    "What one detail would tip that reach for the light from romantic into creepy, or back again?",
    "What might those unexplained tears over the shirts actually be about?"
   ]
  },
  {
   "id": "M2",
   "lines": [
    "L2",
    "L4"
   ],
   "dish": "Knowing the host",
   "claim": "Dev says Nick's claim to be one of the few honest people does not earn trust, and Sam says the parties are fun even though nobody there actually knows the host.",
   "move": "assumptions",
   "question": "What do we expect from someone before we're willing to call their claim of honesty true?",
   "follow_ups": [
    "What would it take to actually know a host whose parties you enjoy?",
    "Why might enjoying a party not require knowing the person who threw it?"
   ]
  }
 ],
 "side": {
  "question": "What's the strongest case that you can really know Nick or the host just by watching what they do?",
  "lines": [
   "L2",
   "L4"
  ]
 },
 "dessert": {
  "question": "Between the gesture toward the green light and the question of who to really trust, what will stick with you after tonight?",
  "lines": []
 },
 "asks": []
}

{
 "task": "menu",
 "book": "Little Women",
 "read_to": "page 120",
 "held_back": "0",
 "lines": "[{\"id\":\"L1\",\"who\":\"Ana\",\"kind\":\"take\",\"ref\":\"\",\"text\":\"loved it\"},{\"id\":\"L2\",\"who\":\"Ben\",\"kind\":\"take\",\"ref\":\"\",\"text\":\"meh\"},{\"id\":\"L3\",\"who\":\"Ana\",\"kind\":\"take\",\"ref\":\"\",\"text\":\"I'll bring the tea and scones\"},{\"id\":\"L4\",\"who\":\"Cleo\",\"kind\":\"take\",\"ref\":\"p. 88\",\"text\":\"page 88\"}]"
}

{
 "task": "menu",
 "verdict": "needs-more",
 "title": "Little Women discussion night",
 "summary": "The lines sent in for Little Women are quick reactions, a snack offer, and a page number, not enough to build tonight's board. A few more thoughts about what members are reading would give the group something to dig into.",
 "starter": {
  "question": "",
  "lines": []
 },
 "mains": [],
 "side": {
  "question": "",
  "lines": []
 },
 "dessert": {
  "question": "",
  "lines": []
 },
 "asks": [
  "What part of the story has stayed with you so far?",
  "Is there a moment you disagreed with or want to talk through?",
  "What's a line that stuck with you, and why?"
 ]
}

const K = DogKit;
const form = K.form({ book: "Frankenstein", read_to: "chapter 16", length: "60", members: "Priya, Tom, Jo",
  lines: "Priya: Victor runs the moment it opens its eyes (ch. 5)\nTom: the creature still chose to kill (ch. 16)\nTom: the ending (ch. 20)" });
console.log(K.flags(form), K.lean(form), K.items(form).held);   // the flags, the page's lean, the lines held back
const wire = K.toWire(K.buildInput("menu", form).input);         // POST this to /estimate and /run
// then: const menu = K.normalize(K.parseReply(job.output.output));
// const { notes } = K.check(menu, form);                          // the page's re-check of the reply
// K.minutes(form.length, menu.mains.length)                      // the minutes for each course

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

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

# input.json: the run input object - {"task": "menu", "book": "Frankenstein by Mary Shelley", "read_to": "chapter 16", "held_back": "1", "lines": "[{\"id\":\"L1\",\"who\":\"Priya\",\"kind\":\"take\",\"ref\":\"ch. 5\",\"text\":\"Victor runs from the creature the moment it opens its eyes (ch. 5) - he's the real monster here\"},{\"id\":\"L2\",\"who\":\"Tom\",\"kind\":\"take\",\"ref\":\"ch. 16\",\"text\":\"I don't buy that. The creature still kills William and nobody made him do it (ch. 16)\"}, ...]"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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