Drive Pumpkin Stencil from your own code

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

{
 "task": "design",
 "idea": "A friendly little ghost for our toddler's first Halloween, to sit on the front porch",
 "mood": "friendly",
 "skill": "first-time",
 "crew": "with-kids",
 "size": "medium",
 "tweak": "",
 "current": "",
 "page_guess": "as-asked"
}

{
 "task": "design",
 "fit": "as-asked",
 "fit_note": "Kept the ghost sweet and simple: big round friendly eyes, a gentle smile, and a small ghost shape for your porch design.",
 "title": "Friendly Little Ghost",
 "concept": "A round-eyed, smiling ghost face sits on your front porch for your toddler's first Halloween, with a small ghost shape tucked near the chin to keep it playful and simple.",
 "design": {
  "eyes": {
   "shape": "round",
   "size": "l",
   "tilt": "level",
   "pupils": "none"
  },
  "brows": {
   "shape": "none",
   "mode": "cut"
  },
  "nose": {
   "shape": "none",
   "mode": "cut"
  },
  "mouth": {
   "shape": "smile",
   "teeth": 0
  },
  "extras": [
   {
    "motif": "ghost",
    "spot": "chin",
    "mode": "cut"
   }
  ]
 },
 "steps": [
  "Tape the stencil onto the clean, dry pumpkin and smooth out any bubbles.",
  "Let your toddler poke holes along every line with a poking tool while you guide their hand.",
  "Peel off the stencil, then have the grown-up carve the small ghost shape near the chin first.",
  "... (6 steps in all)"
 ],
 "tips": [
  "A small serrated pumpkin-carving saw gives gentle control on soft curves.",
  "Rub petroleum jelly on every cut edge to keep the pumpkin fresh longer.",
  "Light it with an LED candle so there is no open flame near your toddler."
 ],
 "reads_as": "From the sidewalk, two big round glowing eyes and a soft curved smile glow like a friendly little ghost, with a tiny ghost shape glimmering near the chin."
}

{
 "task": "design",
 "idea": "Our whole family of five and the dog riding on a hay wagon under a full moon, as realistic as possible, with our last name across the bottom",
 "mood": "spooky",
 "skill": "some-practice",
 "crew": "solo",
 "size": "large",
 "tweak": "",
 "current": "",
 "page_guess": "simplified"
}

{
 "task": "design",
 "fit": "simplified",
 "fit_note": "This keeps the full moon you mentioned and builds a classic spooky jack-o'-lantern face around it; carving can't show a realistic family portrait, a dog, a hay wagon, or lettering, so those are left out.",
 "title": "Full Moon Frown",
 "concept": "A simple spooky jack-o'-lantern face anchored by a glowing full moon, with pointed triangle eyes and nose, a faint web tucked in the corner, and a frowning mouth.",
 "design": {
  "eyes": {
   "shape": "triangle",
   "size": "l",
   "tilt": "level",
   "pupils": "none"
  },
  "brows": {
   "shape": "none",
   "mode": "cut"
  },
  "nose": {
   "shape": "triangle",
   "mode": "cut"
  },
  "mouth": {
   "shape": "frown",
   "teeth": 0
  },
  "extras": [
   {
    "motif": "moon",
    "spot": "top-right",
    "mode": "cut"
   },
   {
    "motif": "web",
    "spot": "top-left",
    "mode": "shave"
   }
  ]
 },
 "steps": [
  "Tape the printed stencil onto the front of the pumpkin and smooth out the wrinkles.",
  "Poke small holes along every line of the pattern to transfer it onto the skin.",
  "Shave the web in the top-left corner first, since it is the most delicate piece.",
  "... (7 steps in all)"
 ],
 "tips": [
  "A craft knife gives cleaner triangle points than a serrated kit saw.",
  "Use a small lino gouge or a vegetable peeler to shave the web so you do not cut all the way through.",
  "Rub petroleum jelly on every cut edge to slow browning, and light it with an LED candle for a steady glow."
 ],
 "reads_as": "From the sidewalk, this reads as a classic, frowning jack-o'-lantern face glowing under a full moon, with a faint web tucked in the corner."
}

{
 "task": "design",
 "idea": "The logo of the burger chain I work at, for the staff pumpkin contest at the restaurant",
 "mood": "silly",
 "skill": "confident",
 "crew": "solo",
 "size": "medium",
 "tweak": "",
 "current": "",
 "page_guess": "swapped"
}

{
 "task": "design",
 "fit": "swapped",
 "fit_note": "Since a real company logo can't be carved from these parts, this is an all-original silly face made for your staff pumpkin contest instead.",
 "title": "Staff Contest Smirk",
 "concept": "An original silly face for your staff pumpkin contest, pairing a winking round eye with arched brows, a button nose and a sly smirk in place of the logo you can't carve directly.",
 "design": {
  "eyes": {
   "shape": "round",
   "size": "m",
   "tilt": "wink",
   "pupils": "pinned"
  },
  "brows": {
   "shape": "arched",
   "mode": "cut"
  },
  "nose": {
   "shape": "button",
   "mode": "cut"
  },
  "mouth": {
   "shape": "smirk",
   "teeth": 0
  },
  "extras": []
 },
 "steps": [
  "Tape the printed stencil onto the front of the pumpkin and press out any wrinkles.",
  "Poke pin holes through the paper along every line of the brows, eyes, nose and mouth to transfer the pattern onto the skin.",
  "Carve the small button nose first, since it is the smallest and most central piece.",
  "... (7 steps in all)"
 ],
 "tips": [
  "A craft knife or small lino gouge works well for the thin smirk line.",
  "Use a serrated pumpkin-carving saw for the bigger brow pieces.",
  "Rub petroleum jelly on every cut edge and light the inside with an LED candle so it glows through the contest."
 ],
 "reads_as": "From the sidewalk it reads as a round winking eye, arched brows, a tiny button nose and a sly smirking mouth glowing in the dark."
}

{
 "task": "design",
 "idea": "A friendly little ghost for our toddler's first Halloween, to sit on the front porch",
 "mood": "friendly",
 "skill": "first-time",
 "crew": "with-kids",
 "size": "medium",
 "tweak": "Make it a bit spookier, but keep it easy enough for the kids",
 "current": "{\"eyes\":{\"shape\":\"round\",\"size\":\"l\",\"tilt\":\"level\",\"pupils\":\"none\"},\"brows\":{\"shape\":\"none ... (235 characters)",
 "page_guess": "as-asked"
}

{
 "task": "design",
 "fit": "as-asked",
 "fit_note": "Kept the round eyes and the ghost on the chin, and gave the mouth a spookier open shape for a bit more spark.",
 "title": "Spooky Little Porch Ghost",
 "concept": "A big, friendly round-eyed face with a wide, spooky-open mouth, plus a small ghost tucked on the chin, simple enough for your toddler's first Halloween pumpkin on the porch.",
 "design": {
  "eyes": {
   "shape": "round",
   "size": "l",
   "tilt": "level",
   "pupils": "none"
  },
  "brows": {
   "shape": "none",
   "mode": "cut"
  },
  "nose": {
   "shape": "none",
   "mode": "cut"
  },
  "mouth": {
   "shape": "open",
   "teeth": 0
  },
  "extras": [
   {
    "motif": "ghost",
    "spot": "chin",
    "mode": "cut"
   }
  ]
 },
 "steps": [
  "Tape the printed stencil onto the clean, dry pumpkin and have the kids smooth it flat.",
  "Poke holes along every line with a pin to transfer the pattern onto the pumpkin skin.",
  "Cut open the top and let the kids scoop out the seeds and pulp.",
  "... (7 steps in all)"
 ],
 "tips": [
  "A small serrated pumpkin saw makes quick work of the eyes and mouth; the tip of a craft knife is best for the tiny ghost shape.",
  "Rub a little petroleum jelly on all the cut edges afterward to help the pumpkin stay fresh longer.",
  "Use a flickering LED candle instead of an open flame, especially with kids nearby."
 ],
 "reads_as": "From the sidewalk, it reads as a big round-eyed face with a wide, startled open mouth and a tiny ghost peeking out near the chin."
}

const K = StencilKit;
const brief = K.brief({ idea: "Our grumpy cat who hates Mondays", mood: "silly", skill: "some-practice", crew: "solo", size: "medium" });
console.log(K.prescan(brief.idea));                      // the page's keyword guess at the fit
const wire = K.toWire(K.buildInput(brief).input);        // POST this to /estimate and /run
// then: const n = K.normalize(K.parseReply(job.output.output));
// const m = K.measure(n.design, brief.size);           // bridges, fine cuts, difficulty, rough minutes
// const { notes } = K.check(n, brief);                 // the page's re-check of the reply
// K.stencilFile(n.design, brief.size)                  // a real-size stencil as an SVG file
// and to change it: K.toWire(K.buildInput(Object.assign({}, brief, { tweak: "Add a bat" }), n.design).input)

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

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

# input.json: the run input object - {"task": "design", "idea": "A friendly little ghost for our toddler's first Halloween, to sit on the front porch", "mood": "friendly", "skill": "first-time", "crew": "with-kids", "size": "medium", "tweak": "", "current": "", "page_guess": "as-asked"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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