Drive Mission Patch from your own code

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

{
 "task": "design",
 "mission": "Our high school robotics team is going to the state championship for the first time. Our robot climbs a bar at the end of every match, and we built it in a garage.",
 "names": "Priya, Marcus, Lena, Tom",
 "name_count": "4",
 "style": "classic",
 "size": "4",
 "tweak": "",
 "current": "",
 "page_guess": "as-asked"
}

{
 "task": "design",
 "fit": "as-asked",
 "fit_note": "Every detail from the brief - the trip to the state championship and all four teammates - made it onto the patch, with the names spaced out instead of separated by dashes so each one fits clearly.",
 "title": "First State Championship",
 "concept": "A high school robotics team heads to the state championship for the first time, powered by a robot that climbs a bar at the end of every match and was built together in a garage.",
 "patch": {
  "shape": "round",
  "top_text": "STATE CHAMPIONSHIP",
  "bottom_text": "PRIYA MARCUS LENA TOM",
  "emblem": "gear",
  "backdrop": "plain",
  "path": "none",
  "stars": 0,
  "accent": "flag",
  "threads": {
   "field": "royal",
   "band": "navy",
   "text": "white",
   "emblem": "silver",
   "accent": "gold",
   "backdrop": "royal"
  }
 },
 "meanings": {
  "shape": "The round shape holds the mission name and every teammate's name together, simple and easy to read.",
  "emblem": "The gear stands for the robot the team built in a garage.",
  "backdrop": "",
  "path": "",
  "stars": "",
  "accent": "The flag marks the team's first trip to the state championship.",
  "colors": "The royal blue background and white lettering keep the team's name and the championship easy to read, while the silver gear and gold flag stand out as marks of the team's work and this milestone."
 },
 "tips": [
  "Send the real-size file straight to a patch maker so the lettering stitches at the size shown here.",
  "Choose a merrowed edge for this round shape.",
  "... (3 tips in all)"
 ],
 "at_a_glance": "A silver gear with a small gold flag sits on a royal blue background, framed by a navy border lettered in white with the state championship and all four teammates' names."
}

{
 "task": "design",
 "mission": "Family reunion road trip in a rented minivan, from the lake house to the canyon. Make it as realistic as possible, with the van, the canyon at sunset and everyone's faces.",
 "names": "Rose, Dave, Mia, Sam, Jo, Kenji, Ava, Leo, Nora",
 "name_count": "9",
 "style": "retro",
 "size": "4",
 "tweak": "",
 "current": "",
 "page_guess": "simplified"
}

{
 "task": "design",
 "fit": "simplified",
 "fit_note": "Kept the canyon and its sunset, shown as mountains with a sun beside the compass, and left out the realistic van and everyone's faces, which the drawer cannot draw; gave one star to each of the nine names instead of placing them on the border.",
 "title": "Family Reunion Road Trip",
 "concept": "A compass with a dotted trail stands for the road trip from the lake house to the canyon, set against mountains with a sun for the sunset at the end. Nine stars stand for the nine people on the trip.",
 "patch": {
  "shape": "oval",
  "top_text": "FAMILY REUNION TRIP",
  "bottom_text": "LAKE HOUSE TO CANYON",
  "emblem": "compass",
  "backdrop": "mountains",
  "path": "trail",
  "stars": 9,
  "accent": "sun",
  "threads": {
   "field": "sand",
   "band": "maroon",
   "text": "gold",
   "emblem": "brown",
   "accent": "orange",
   "backdrop": "teal"
  }
 },
 "meanings": {
  "shape": "The oval shape gives the patch a classic badge look for marking a trip.",
  "emblem": "The compass stands for the road trip, pointing the way from the lake house to the canyon.",
  "backdrop": "The mountains stand for the canyon the trip ends at.",
  "path": "The dotted trail traces the route the family drives, from the lake house to the canyon.",
  "stars": "The nine stars stand for the nine people on the trip.",
  "accent": "The sun stands for the sunset at the canyon.",
  "colors": "The sand, maroon, gold, brown, orange and teal threads give the patch a warm, sunset-toned feel."
 },
 "tips": [
  "Send the page's real-size file to a patch maker so the stitching comes out at true scale.",
  "An oval shape works well with a merrowed (wrapped) edge.",
  "... (3 tips in all)"
 ],
 "at_a_glance": "From across a room you see a sand oval patch with a brown compass and a dotted trail over teal mountains, an orange sun beside it, nine stars above, and gold lettering on a maroon border naming the trip and its route."
}

{
 "task": "design",
 "mission": "Our astronomy club, Backyard Skies, is watching the Phobos sample-return launch stream together. Make it an exact copy of the space agency's official logo, just with our club name on it.",
 "names": "",
 "name_count": "0",
 "style": "classic",
 "size": "3",
 "tweak": "",
 "current": "",
 "page_guess": "swapped"
}

{
 "task": "design",
 "fit": "swapped",
 "fit_note": "Replaced the real agency's logo with an original design; kept the club and the Phobos launch they watched together, built from a telescope, an arc and a moon instead of that agency's marks.",
 "title": "Backyard Skies Phobos Launch",
 "concept": "A patch for Backyard Skies, marking the club's watching of the Phobos launch stream together, with a telescope standing for the club and an arc and moon tracing the launch they watched.",
 "patch": {
  "shape": "round",
  "top_text": "BACKYARD SKIES",
  "bottom_text": "PHOBOS LAUNCH STREAM",
  "emblem": "telescope",
  "backdrop": "starfield",
  "path": "arc",
  "stars": 0,
  "accent": "moon",
  "threads": {
   "field": "navy",
   "band": "maroon",
   "text": "gold",
   "emblem": "silver",
   "accent": "gold",
   "backdrop": "sky"
  }
 },
 "meanings": {
  "shape": "The round shape holds the club's name and the launch they watched in one unbroken ring.",
  "emblem": "The telescope stands for the astronomy club watching together.",
  "backdrop": "The starfield represents the astronomy club watching the sky.",
  "path": "The arc traces the launch the club watched together.",
  "stars": "",
  "accent": "The moon stands for Phobos, named in the launch the club watched together.",
  "colors": "The navy background and maroon border carry gold lettering, a silver telescope, a gold arc and moon, and a sky-blue backdrop that echoes the club's own name."
 },
 "tips": [
  "Send this real-size file to a patch maker.",
  "Choose a merrowed edge for the round shape.",
  "... (3 tips in all)"
 ],
 "at_a_glance": "From across the room: a silver telescope under a gold arc and moon, ringed in gold lettering naming Backyard Skies and the Phobos launch."
}

{
 "task": "design",
 "mission": "Our high school robotics team is going to the state championship for the first time. Our robot climbs a bar at the end of every match, and we built it in a garage.",
 "names": "Priya, Marcus, Lena, Tom",
 "name_count": "4",
 "style": "classic",
 "size": "4",
 "tweak": "Make it retro, and add a moon for the late nights in the garage",
 "current": "{\"shape\":\"round\",\"top_text\":\"STATE CHAMPIONSHIP\",\"bottom_text\":\"PRIYA MARCUS LENA TOM\",\"em ... (272 characters)",
 "page_guess": "as-asked"
}

{
 "task": "design",
 "fit": "as-asked",
 "fit_note": "Keeps the round shape, the gear for the robot, and all four names along the border; adds a moon beside the gear for the garage nights and shifts the thread colors to a warm retro mix.",
 "title": "First State Championship",
 "concept": "This patch marks a high school robotics team's first trip to the state championship, centered on a gear for the robot that climbs a bar at the end of every match. A moon beside it marks the late nights spent building in the garage, with Priya, Marcus, Lena, and Tom named along the border in a warm retro palette.",
 "patch": {
  "shape": "round",
  "top_text": "STATE CHAMPIONSHIP",
  "bottom_text": "PRIYA MARCUS LENA TOM",
  "emblem": "gear",
  "backdrop": "plain",
  "path": "none",
  "stars": 0,
  "accent": "moon",
  "threads": {
   "field": "maroon",
   "band": "sand",
   "text": "brown",
   "emblem": "gold",
   "accent": "teal",
   "backdrop": "maroon"
  }
 },
 "meanings": {
  "shape": "The round shape gives a classic look and leaves room on the border for the team's four names.",
  "emblem": "The gear represents the robot the team built and the climb it makes at the end of every match.",
  "backdrop": "",
  "path": "",
  "stars": "",
  "accent": "The moon stands for the late nights the team spent working in the garage.",
  "colors": "The retro mix of maroon, sand, brown, gold, and teal gives the patch a warm, vintage feel to match a team built in a garage."
 },
 "tips": [
  "Send the full-size file to a patch maker so the lettering stays legible.",
  "Choose a merrowed (wrapped) edge, which suits this round shape.",
  "... (3 tips in all)"
 ],
 "at_a_glance": "From across the room: a round patch with a gold gear and a small teal moon on a maroon background, STATE CHAMPIONSHIP along the top border and Priya, Marcus, Lena, and Tom named along the bottom."
}

const K = PatchKit;
const brief = K.brief({ mission: "My PhD thesis on river ice, defended this spring", names: "", style: "minimal", size: "4" });
console.log(K.prescan(brief.mission, brief.names));   // 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.patch, brief.size);         // letter heights, star size, threads, contrast, rough stitches
// const { notes } = K.check(n, brief);              // the page's re-check of the reply
// K.patchFile(n.patch, brief.size, brief.style)     // a real-size patch as an SVG file
// and to change it: K.toWire(K.buildInput(Object.assign({}, brief, { tweak: "Add a moon" }), n.patch).input)

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

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

# input.json: the run input object - {"task": "design", "mission": "Our high school robotics team is going to the state championship for the first time. Our robot climbs a bar at the end of every match, and we built it in a garage.", "names": "Priya, Marcus, Lena, Tom", "name_count": "4", "style": "classic", "size": "4", "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="mission-patch: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: mission-patch:design:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json