Drive Pumpkin Afterlife from your own code

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

{"task": "route", "verdict": "clear-today", "headline": "...", "items": [{"item": "1", "route": "compost", "why": "...", "before": "..."}], "first": {"item": "1", "step": "..."}, "closing": "..."}

{
 "task": "route",
 "pile": "house rules: checked in order - painted, glitter, spray or glue: bin | display kept up, whole and firm: keep | you cook, whole and firm, not an ornamental gourd: kitchen | a compost heap: compost | a food-waste caddy: caddy | otherwise: bin | deal with first: the leaving pumpkin with the highest urgency (mould 3, soft spots 2, frost-hit 2, carved +2, on show 14 days or more +1), the earliest on a tie | verdict: all-staying when none leaves, clear-today when any leaving pumpkin is carved or has soft spots or mould, otherwise clear-soon\nhousehold: display kept up while it lasts | cooks pumpkin: no | compost heap: yes | food-waste caddy: no\ntotals: 3 pumpkins | keep: 3 | kitchen: 0 | compost: 0 | caddy: 0 | bin: 0 | verdict: all-staying | deal with first: none\nitem 1 | big orange pumpkin by the door | kind: carving pumpkin | cut: whole | finish: plain | condition: firm | on show: 12 days | note: stem still green | route: keep\nitem 2 | warty white pumpkin | kind: carving pumpkin | cut: whole | finish: plain | condition: firm | on show: 20 days | note: none | route: keep\nitem 3 | bowl of striped gourds | kind: ornamental gourd | cut: whole | finish: plain | condition: firm | on show: 9 days | note: shiny and hard | route: keep"
}

{
 "task": "route",
 "verdict": "all-staying",
 "headline": "Nothing leaves the display - every pumpkin stays on show.",
 "items": [
  {
   "item": "1",
   "route": "keep",
   "why": "This big orange pumpkin is whole and firm, with a still-green stem, and the display is staying up.",
   "before": "Keep an eye on its base for any soft spots while it stays on show."
  },
  {
   "item": "2",
   "route": "keep",
   "why": "Staying whole and firm, this warty white pumpkin keeps its place while the display stays up.",
   "before": "Wipe off any dust and check it is still sitting steady on show."
  },
  {
   "item": "3",
   "route": "keep",
   "why": "This bowl of striped gourds is whole and firm, shiny and hard, while the display stays up.",
   "before": "Give the bowl a shake and check each gourd still feels firm and sound."
  }
 ],
 "first": {
  "item": "",
  "step": ""
 },
 "closing": "Relax, your pumpkins and gourd bowl get to carry on looking smug on show."
}

{
 "task": "route",
 "pile": "house rules: checked in order - painted, glitter, spray or glue: bin | display kept up, whole and firm: keep | you cook, whole and firm, not an ornamental gourd: kitchen | a compost heap: compost | a food-waste caddy: caddy | otherwise: bin | deal with first: the leaving pumpkin with the highest urgency (mould 3, soft spots 2, frost-hit 2, carved +2, on show 14 days or more +1), the earliest on a tie | verdict: all-staying when none leaves, clear-today when any leaving pumpkin is carved or has soft spots or mould, otherwise clear-soon\nhousehold: display coming down now | cooks pumpkin: yes | compost heap: yes | food-waste caddy: no\ntotals: 4 pumpkins | keep: 0 | kitchen: 1 | compost: 2 | caddy: 0 | bin: 1 | verdict: clear-today | deal with first: item 1 (urgency 5)\nitem 1 | carved cat face pumpkin | kind: carving pumpkin | cut: carved | finish: candle-lit (wax inside) | condition: mould | on show: 6 days | note: furry patches inside the lid | route: compost\nitem 2 | butternut squash from the step | kind: eating pumpkin or squash | cut: whole | finish: plain | condition: firm | on show: 15 days | note: skin still glossy | route: kitchen\nitem 3 | glitter pumpkin | kind: carving pumpkin | cut: whole | finish: glitter, spray or glue | condition: firm | on show: 15 days | note: gold spray and sequins | route: bin\nitem 4 | small sugar pumpkin | kind: eating pumpkin or squash | cut: whole | finish: plain | condition: soft spots | on show: 15 days | note: a soft patch near the base | route: compost"
}

{
 "task": "route",
 "verdict": "clear-today",
 "headline": "Clear today, 4 pumpkins are leaving and 0 are staying on show.",
 "items": [
  {
   "item": "1",
   "route": "compost",
   "why": "Carved and showing mould, it can't go to the kitchen or stay on show, and you have a compost heap.",
   "before": "Take out the candle and wax, then chop it into chunks so it breaks down."
  },
  {
   "item": "2",
   "route": "kitchen",
   "why": "Whole and firm, it isn't an ornamental gourd, and you cook pumpkin, so this squash goes to the kitchen.",
   "before": "Wash it, then cut it open and use it soon, you could scoop out the seeds first."
  },
  {
   "item": "3",
   "route": "bin",
   "why": "Covered in glitter, spray or glue, eating or composting it is ruled out, despite being whole and firm.",
   "before": "Pick off the sequins and any other removable add-ons before it goes in the bin."
  },
  {
   "item": "4",
   "route": "compost",
   "why": "Though whole, its soft spots rule out the kitchen and staying on show, and you have a compost heap.",
   "before": "Break it into smaller pieces so it composts down well."
  }
 ],
 "first": {
  "item": "1",
  "step": "First, take the candle and wax out of the carved cat face pumpkin, then chop it into chunks."
 },
 "closing": "With 4 pumpkins on the move today, start with that carved cat face pumpkin's candle and wax."
}

{
 "task": "route",
 "pile": "house rules: checked in order - painted, glitter, spray or glue: bin | display kept up, whole and firm: keep | you cook, whole and firm, not an ornamental gourd: kitchen | a compost heap: compost | a food-waste caddy: caddy | otherwise: bin | deal with first: the leaving pumpkin with the highest urgency (mould 3, soft spots 2, frost-hit 2, carved +2, on show 14 days or more +1), the earliest on a tie | verdict: all-staying when none leaves, clear-today when any leaving pumpkin is carved or has soft spots or mould, otherwise clear-soon\nhousehold: display coming down now | cooks pumpkin: yes | compost heap: no | food-waste caddy: yes\ntotals: 3 pumpkins | keep: 0 | kitchen: 1 | compost: 0 | caddy: 1 | bin: 1 | verdict: clear-soon | deal with first: item 2 (urgency 2)\nitem 1 | tall carving pumpkin | kind: carving pumpkin | cut: whole | finish: plain | condition: firm | on show: 10 days | note: none | route: kitchen\nitem 2 | knobbly yellow gourd | kind: ornamental gourd | cut: whole | finish: plain | condition: frost-hit | on show: 10 days | note: went dull and wrinkly after a cold night | route: caddy\nitem 3 | painted pumpkin with a face | kind: carving pumpkin | cut: whole | finish: painted | condition: firm | on show: 16 days | note: acrylic paint all over | route: bin"
}

{
 "task": "route",
 "verdict": "clear-soon",
 "headline": "Clear this week - 3 pumpkins leave the display, 0 stay.",
 "items": [
  {
   "item": "1",
   "route": "kitchen",
   "why": "This tall carving pumpkin is whole and firm, and you cook pumpkin, so it heads to the kitchen.",
   "before": "Wash it, cut it open and use it soon - scoop out the seeds as you go."
  },
  {
   "item": "2",
   "route": "caddy",
   "why": "Whole yet frost-hit, this ornamental gourd skips the kitchen and the show; with no compost heap, caddy it is.",
   "before": "Cut it into pieces small enough to fit the caddy."
  },
  {
   "item": "3",
   "route": "bin",
   "why": "Firm and whole, this carving pumpkin still can't be eaten or composted because it's painted - general bin.",
   "before": "Pick off any pins, sequins or add-ons you can remove, then bag it for the bin."
  }
 ],
 "first": {
  "item": "2",
  "step": "First, cut the knobbly yellow gourd into pieces that fit the caddy."
 },
 "closing": "Start with that frost-hit gourd, then let the rest of your pumpkin round-up carry on through the week."
}

{
 "task": "route",
 "pile": "house rules: checked in order - painted, glitter, spray or glue: bin | display kept up, whole and firm: keep | you cook, whole and firm, not an ornamental gourd: kitchen | a compost heap: compost | a food-waste caddy: caddy | otherwise: bin | deal with first: the leaving pumpkin with the highest urgency (mould 3, soft spots 2, frost-hit 2, carved +2, on show 14 days or more +1), the earliest on a tie | verdict: all-staying when none leaves, clear-today when any leaving pumpkin is carved or has soft spots or mould, otherwise clear-soon\nhousehold: display coming down now | cooks pumpkin: no | compost heap: no | food-waste caddy: no\ntotals: 3 pumpkins | keep: 0 | kitchen: 0 | compost: 0 | caddy: 0 | bin: 3 | verdict: clear-today | deal with first: item 1 (urgency 4)\nitem 1 | carved lantern with stars | kind: carving pumpkin | cut: carved | finish: candle-lit (wax inside) | condition: soft spots | on show: 5 days | note: lid caving in | route: bin\nitem 2 | carved owl pumpkin | kind: carving pumpkin | cut: carved | finish: plain | condition: soft spots | on show: 5 days | note: edges shrivelled | route: bin\nitem 3 | mini pumpkin on the windowsill | kind: carving pumpkin | cut: whole | finish: plain | condition: firm | on show: 20 days | note: none | route: bin"
}

{
 "task": "route",
 "verdict": "clear-today",
 "headline": "Clear today: 3 pumpkins leave, 0 stay on show.",
 "items": [
  {
   "item": "1",
   "route": "bin",
   "why": "It's carved with soft spots, the display is coming down, and you have no compost heap or food-waste caddy.",
   "before": "Take out the candle and wax, then bag it."
  },
  {
   "item": "2",
   "route": "bin",
   "why": "Carved with soft spots, it can't stay on show or go to kitchen, with no compost heap or food-waste caddy.",
   "before": "Bag it up for the general bin."
  },
  {
   "item": "3",
   "route": "bin",
   "why": "Whole and firm, but the display is coming down, you don't cook, and there's no compost heap or food-waste caddy.",
   "before": "Pop it into a bag for the general bin before it goes out."
  }
 ],
 "first": {
  "item": "1",
  "step": "Take the candle and wax out of the carved lantern with stars, then bag it."
 },
 "closing": "Start with that carved lantern - today's the day these pumpkins head out the door."
}

const K = PumpKit;
const built = K.buildInput(K.form({ house: { display: "down", cook: "yes", heap: "no", caddy: "yes" }, items: [
  { text: "big round pumpkin", kind: "carving", cut: "whole", finish: "plain", cond: "firm", days: 9, note: "" },
  { text: "carved bat lantern", kind: "carving", cut: "carved", finish: "candle", cond: "soft", days: 4, note: "edges curling" }] }));
built.input.pile;                       // the page's lines: rules, household, totals and one line per pumpkin
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 display")     // the routes as Markdown

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

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

# input.json: the run input object - {"task": "route", "pile": "house rules: checked in order - painted, glitter, spray or glue: bin ...
household: display coming down now | cooks pumpkin: yes | compost heap: yes | food-waste caddy: no
totals: 4 pumpkins | keep: 0 | kitchen: 1 | compost: 2 | caddy: 0 | bin: 1 | verdict: clear-today | deal with first: item 1 (urgency 5)
item 1 | carved cat face pumpkin | kind: carving pumpkin | cut: carved | ... | route: compost
..."}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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