Drive First Badges from your own code

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

{
 "task": "sash",
 "age": "9",
 "nickname": "Robin",
 "can_do": "rides a bike without stabilisers\nmakes toast\nties shoes\ncracks eggs into a bowl\nwalks to the corner shop with me",
 "into": "dinosaurs\nbuilding forts out of cushions\ncomic books",
 "grownup": "fixing bikes\nbaking bread",
 "minutes": "120",
 "focus": "any",
 "page_sash": "full",
 "page_counts": "minutes a week 120; can-do lines 5; into lines 3; badges 6",
 "page_ideas": "hands: Button Mender\naround: Map Reader\npeople: Phone Caller\nbody: Scrape Fixer\n ... (243 characters)"
}

{
 "task": "sash",
 "sash": "full",
 "title": "Robin's First Badges Sash",
 "badges": [
  {
   "name": "Street Crosser",
   "area": "around",
   "step": "ready",
   "builds_on": "walks to the corner shop with me",
   "first_step": "",
   "why": "Robin already walks to the corner shop with you, so learning to check and cross a street safely is a natural next step.",
   "lesson": {
    "minutes": 15,
    "you_need": [
     "comfortable shoes"
    ],
    "steps": [
     "You stop at the curb, look both ways out loud, and say when it is clear to cross.",
     "Cross together, with them checking both ways out loud and you confirming before you step off the curb.",
     "They check both ways and decide when to cross while you watch closely from beside them."
    ],
    "say": "Let's practice checking both ways before we cross, just like we do together."
   },
   "look_for": "Robin stops at the curb, looks both ways out loud, and waits for a clear gap before crossing.",
   "practice": "Have them lead the looking and timing every time you cross a street together.",
   "safety": "Stay right beside Robin at the kerb, and Robin does not cross a road without you yet."
  },
  {
   "name": "Bike Checker",
   "area": "hands",
   "step": "ready",
   "builds_on": "rides a bike without stabilisers",
   "first_step": "",
   "why": "Robin already rides a bike without stabilisers, and you know how to fix bikes, so checking it together is a natural next step.",
   "lesson": {
    "minutes": 15,
    "you_need": [
     "the bike"
    ],
    "steps": [
     "You squeeze each tyre and press the brake levers, saying what firm tyres and good brakes should feel like.",
     "Check the bike together, you holding it steady while they squeeze the tyres and test the brakes.",
     "They check the tyres and brakes alone while you watch, then tell you if anything feels off."
    ],
    "say": "Let's check your bike together before you ride, so you know it's ready to go."
   },
   "look_for": "Robin checks their own tyres and brakes before a ride without being asked and tells you what they find.",
   "practice": "Have them check the bike together before every ride until it becomes automatic.",
   "safety": ""
  },
  "... (6 badges in all)"
 ],
 "note": "Start with one badge a week in the order given, and keep practicing the earlier ones so each new skill sticks.",
 "asks": []
}

{
 "task": "sash",
 "age": "13",
 "nickname": "",
 "can_do": "makes pasta on the stove\ntakes the bus to school\nhas a bank card\ndoes homework without reminders",
 "into": "skateboarding\nediting videos",
 "grownup": "spreadsheets\nsewing",
 "minutes": "60",
 "focus": "money",
 "page_sash": "half",
 "page_counts": "minutes a week 60; can-do lines 4; into lines 2; badges 4",
 "page_ideas": "money: Budget Keeper\nmind: Week Planner\nhands: Flat Fixer\nhome: Laundry Runner\na ... (249 characters)"
}

{
 "task": "sash",
 "sash": "half",
 "title": "Money and Time Skills Sash",
 "badges": [
  {
   "name": "Budget Keeper",
   "area": "money",
   "step": "ready",
   "builds_on": "has a bank card",
   "first_step": "",
   "why": "Your kid already has a bank card, so keeping track of what goes in and out of it is a good next skill.",
   "lesson": {
    "minutes": 15,
    "you_need": [
     "the bank card",
     "a notebook",
     "a pen"
    ],
    "steps": [
     "You look at a recent bank statement together, pointing out what each charge was for.",
     "You write down a few recent purchases together in a simple spending notebook.",
     "They log their own spending for a few days alone while you check in."
    ],
    "say": "Let's look at your bank card spending and start tracking it together."
   },
   "look_for": "Your kid writes down what they spent without being asked or reminded.",
   "practice": "Check the spending notebook together each week and add any new purchases.",
   "safety": ""
  },
  {
   "name": "Week Planner",
   "area": "mind",
   "step": "ready",
   "builds_on": "does homework without reminders",
   "first_step": "",
   "why": "Your kid already does homework without reminders, so planning a weekly schedule around skating and video projects is a good next step.",
   "lesson": {
    "minutes": 15,
    "you_need": [
     "a sheet of paper",
     "a pen"
    ],
    "steps": [
     "You map out this week on paper, saying out loud why each block goes where.",
     "You fill in time for skating and video editing together on the plan.",
     "They plan out their own week alone while you look over the result after."
    ],
    "say": "Let's plan out your week together, including time for skating and editing."
   },
   "look_for": "Your kid fills in a weekly plan alone, including school, chores and free time.",
   "practice": "Plan the coming week together each week until they start doing it alone.",
   "safety": ""
  },
  "... (4 badges in all)"
 ],
 "note": "Start with one badge a week, keep the earlier ones going, and move to the next when your kid is ready.",
 "asks": []
}

{
 "task": "sash",
 "age": "5",
 "nickname": "Juno",
 "can_do": "brushes teeth",
 "into": "",
 "grownup": "",
 "minutes": "30",
 "focus": "any",
 "page_sash": "starter",
 "page_counts": "minutes a week 30; can-do lines 1; into lines 0; badges 3",
 "page_ideas": "hands: Lace Tier\nmoney: Coin Namer\naround: Address Keeper\npeople: Hello Sayer\nho ... (247 characters)"
}

{
 "task": "sash",
 "sash": "starter",
 "title": "Juno's First Badges Sash",
 "badges": [
  {
   "name": "Shoe Lacer",
   "area": "hands",
   "step": "stretch",
   "builds_on": "",
   "first_step": "Threading a lace through each shoe hole in order, pulling it snug after every pass.",
   "why": "Many kids start managing their own shoelaces around this age.",
   "lesson": {
    "minutes": 15,
    "you_need": [
     "a lace-up shoe"
    ],
    "steps": [
     "You thread a lace through one hole while saying what you are doing out loud.",
     "You and your kid thread a few holes together, taking turns pulling each lace snug.",
     "They lace the shoe alone while you watch and step in only if asked."
    ],
    "say": "Let's see how far you can lace this shoe today."
   },
   "look_for": "Juno threads each hole in order and pulls the lace snug without any help.",
   "practice": "Let Juno lace their own shoes most days before putting them on.",
   "safety": ""
  },
  {
   "name": "Steady Pourer",
   "area": "kitchen",
   "step": "stretch",
   "builds_on": "",
   "first_step": "Pouring a little water from one cup into another without spilling any of it.",
   "why": "Many kids start pouring their own drinks around this age.",
   "lesson": {
    "minutes": 10,
    "you_need": [
     "a small jug",
     "two cups",
     "a towel"
    ],
    "steps": [
     "You pour slowly from the jug into a cup while saying what you are doing.",
     "You hold the jug together and pour into a cup, taking turns tipping it slowly.",
     "They pour from the jug into a cup alone while you watch for any spills."
    ],
    "say": "Want to practice pouring your own drink today?"
   },
   "look_for": "Juno tips the jug and stops pouring right at the top of the cup without spilling.",
   "practice": "Let Juno pour their own drink at the table most days.",
   "safety": "Stay next to Juno while pouring, and keep anything hot off the table for now."
  },
  "... (3 badges in all)"
 ],
 "note": "Start one badge this week, and keep practicing the earlier ones as you add new ones.",
 "asks": [
  "List a few more things your kid can already do without help.",
  "Name one thing your kid is into right now, even something small.",
  "Say what you enjoy teaching so this next sash can use it."
 ]
}

{
 "task": "sash",
 "age": "15",
 "nickname": "Ash",
 "can_do": "cooks a simple dinner\ndoes own laundry\nrides the bus across town\nkeeps a savings jar",
 "into": "climbing\nsci-fi novels\nfixing old phones",
 "grownup": "car maintenance\nbudgeting",
 "minutes": "180",
 "focus": "around",
 "page_sash": "full",
 "page_counts": "minutes a week 180; can-do lines 4; into lines 3; badges 6",
 "page_ideas": "around: Trip Planner\nmoney: Budget Keeper\nkitchen: Family Cook\npeople: Appointme ... (255 characters)"
}

{
 "task": "sash",
 "sash": "full",
 "title": "Ash's Around and Money Sash",
 "badges": [
  {
   "name": "Trip Planner",
   "area": "around",
   "step": "ready",
   "builds_on": "rides the bus across town",
   "first_step": "",
   "why": "Ash already rides the bus across town, so planning a new route with a transfer is a good next step.",
   "lesson": {
    "minutes": 20,
    "you_need": [
     "a phone or printed map",
     "a notebook"
    ],
    "steps": [
     "You look up a new bus route with a transfer, saying each step out loud as you plan.",
     "You ride the new route together once, pointing out each stop and transfer along the way.",
     "They plan and ride the same new route alone while you wait at the end stop."
    ],
    "say": "Let's plan a new bus route with a transfer and try it together."
   },
   "look_for": "Ash plans a new route with a transfer and rides it alone without help.",
   "practice": "Plan and ride a different new bus route together every so often.",
   "safety": "You stay reachable and nearby while Ash tries the route, and Ash checks in with you if plans change."
  },
  {
   "name": "Recipe Reader",
   "area": "kitchen",
   "step": "ready",
   "builds_on": "cooks a simple dinner",
   "first_step": "",
   "why": "Ash already cooks a simple dinner, so learning to read and follow a new recipe is a good next step.",
   "lesson": {
    "minutes": 20,
    "you_need": [
     "a written recipe",
     "a few ingredients",
     "a pan"
    ],
    "steps": [
     "You read a recipe out loud together, explaining what each step and measurement means.",
     "You cook the recipe together, taking turns on each step and checking it twice.",
     "They read and cook a new recipe alone while you watch nearby at the stove."
    ],
    "say": "Let's pick a new recipe and read through it together before cooking."
   },
   "look_for": "Ash reads a new recipe and cooks it alone without checking each step with you.",
   "practice": "Pick a new recipe together every so often and let Ash lead the cooking.",
   "safety": "You stay in the kitchen near the stove while Ash cooks, and Ash does not handle hot pans alone yet."
  },
  "... (6 badges in all)"
 ],
 "note": "Start with one badge a week, keep the earlier ones going, and let Ash take the lead once each skill is comfortable.",
 "asks": []
}

const K = BadgeKit;
const form = { age: "9", nickname: "Robin", can_do: "rides a bike without stabilisers\nmakes toast\ncracks eggs into a bowl",
  into: "dinosaurs", grownup: "fixing bikes", minutes: "120", focus: "any" };
console.log(K.lean(form));                                // the sash size and why
console.log(K.ideas(form).map(e => e.name));              // the starter list's ideas for this age (rough guide)
const wire = K.toWire(K.buildInput(form).input);          // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// const { notes, weeks } = K.check(reply, form);         // the page's re-check and the one-a-week schedule
// K.plainText(reply, form)                               // the lesson cards as plain text
// K.draft(form)                                          // the free draft sash, from the starter list alone

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

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

# input.json: the run input object - {"task": "sash", "age": "9", "nickname": "Robin", "can_do": "rides a bike without stabilisers\nmakes toast\n...", "into": "dinosaurs\n...", "grownup": "fixing bikes\nbaking bread", "minutes": "120", "focus": "any", "page_sash": "full", "page_counts": "minutes a week 120; ...", "page_ideas": "hands: Button Mender\n..."}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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