Drive Slice for Slice from your own code

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

{"task": "compare", "verdict": "clear-pick", "pick": "...", "headline": "...", "rows": [{"option": "...", "taste": "...", "wishes": ["meets"], "best_for": "...", "watch_out": "..."}, ...], "pick_note": "...", "closing": "..."}

{
 "task": "compare",
 "occasion": "Christmas Eve at my in-laws",
 "wishes": "wish 1 | no marzipan\nwish 2 | something chocolatey",
 "shelf": "currency: £\nbudget per cake: 25.00\nslices needed: 12\noption 1 | Classic panettone | price 12.00 | 1000 g | 12 slices (given) | 1.00 per slice | 1.20 per 100 g | fits\noption 2 | Pandoro star | price 9.00 | 750 g | 8 slices (given) | 1.13 per slice | 1.20 per 100 g | does not fit: too few slices\noption 3 | Stollen loaf | price 10.00 | 750 g | 9 slices (estimated at 1 per 80 g) | 1.11 per slice | 1.33 per 100 g | does not fit: too few slices\noption 4 | Chocolate panettone | price 16.00 | 1000 g | 12 slices (given) | 1.33 per slice | 1.60 per 100 g | fits\nfitting order (cheapest per slice first): option 1, option 4\nverdict: clear-pick\npick: option 1 | Classic panettone\nrunner-up: none\nclosest: none",
 "notes": "option 1 | candied orange and raisins, tall dome\noption 2 | plain buttery sponge, comes with icing sugar\noption 3 | marzipan centre, dusted with icing sugar\noption 4 | chocolate chips, no candied peel"
}

{
 "task": "compare",
 "verdict": "clear-pick",
 "pick": "Classic panettone",
 "headline": "Classic panettone is the cheapest per slice of the cakes that fit.",
 "rows": [
  {
   "option": "Classic panettone",
   "taste": "Candied orange and raisins, with a tall dome.",
   "wishes": [
    "unknown",
    "unknown"
   ],
   "best_for": "Cheapest per slice of the cakes that fit, £1.00.",
   "watch_out": "Its note doesn't mention marzipan or anything chocolatey."
  },
  {
   "option": "Pandoro star",
   "taste": "Plain buttery sponge that comes with icing sugar.",
   "wishes": [
    "unknown",
    "misses"
   ],
   "best_for": "Lowest price on the shelf, £9.00.",
   "watch_out": "Just 8 slices, short of the 12 needed."
  },
  {
   "option": "Stollen loaf",
   "taste": "Marzipan centre, dusted with icing sugar.",
   "wishes": [
    "misses",
    "unknown"
   ],
   "best_for": "Comes dusted with icing sugar.",
   "watch_out": "Only 9 slices, below the 12 needed."
  },
  {
   "option": "Chocolate panettone",
   "taste": "Chocolate chips, with no candied peel.",
   "wishes": [
    "unknown",
    "meets"
   ],
   "best_for": "Ties for the most slices on the shelf, 12.",
   "watch_out": "Its note says nothing about marzipan."
  }
 ],
 "pick_note": "Classic panettone comes first for you because it costs £1.00 per slice, against £1.33 for Chocolate panettone, the next cake that fits.",
 "closing": "Check the label for marzipan before you decide."
}

{
 "task": "compare",
 "occasion": "Friday treat for the office team",
 "wishes": "wish 1 | no raisins",
 "shelf": "currency: $\nbudget per cake: 30.00\nslices needed: 16\noption 1 | Big classic panettone | price 24.00 | 1500 g | 18 slices (given) | 1.33 per slice | 1.60 per 100 g | fits\noption 2 | Twin 750 g pack | price 22.00 | 1500 g | 16 slices (given) | 1.38 per slice | 1.47 per 100 g | fits\noption 3 | Fruitcake slab | price 19.00 | 1200 g | 15 slices (estimated at 1 per 80 g) | 1.27 per slice | 1.58 per 100 g | does not fit: too few slices\nfitting order (cheapest per slice first): option 1, option 2\nverdict: close-call\npick: option 1 | Big classic panettone\nrunner-up: option 2 | Twin 750 g pack\nclosest: none",
 "notes": "option 1 | raisins and candied peel\noption 2 | plain, no fruit, individually wrapped\noption 3 | dark fruitcake with brandy"
}

{
 "task": "compare",
 "verdict": "close-call",
 "pick": "Big classic panettone",
 "headline": "Big classic panettone and Twin 750 g pack are nearly level on price per slice.",
 "rows": [
  {
   "option": "Big classic panettone",
   "taste": "Raisins and candied peel.",
   "wishes": [
    "misses"
   ],
   "best_for": "Lowest price per slice among the fitting cakes, $1.33.",
   "watch_out": "It misses the wish to avoid raisins, since it has raisins and candied peel."
  },
  {
   "option": "Twin 750 g pack",
   "taste": "Plain, no fruit, individually wrapped.",
   "wishes": [
    "meets"
   ],
   "best_for": "Meets the wish against raisins, since it has no fruit.",
   "watch_out": "Costs $1.38 per slice, more than Big classic panettone's $1.33."
  },
  {
   "option": "Fruitcake slab",
   "taste": "Dark fruitcake with brandy.",
   "wishes": [
    "unknown"
   ],
   "best_for": "Lowest price on the shelf, at $19.00.",
   "watch_out": "Only has 15 slices, short of the 16 needed."
  }
 ],
 "pick_note": "Big classic panettone costs $1.33 per slice, Twin 750 g pack $1.38 - close enough for taste to decide, since their notes differ: raisins and candied peel against no fruit. Big classic panettone misses your wish for no raisins; Twin 750 g pack marks no misses.",
 "closing": "Check the label for raisins before choosing between Big classic panettone and Twin 750 g pack."
}

{
 "task": "compare",
 "occasion": "dessert after a dinner for 10",
 "wishes": "wish 1 | not too sweet\nwish 2 | under 15",
 "shelf": "currency: €\nbudget per cake: 15.00\nslices needed: 10\noption 1 | Bakery panettone | price 28.00 | 1000 g | 12 slices (given) | 2.33 per slice | 2.80 per 100 g | does not fit: over budget\noption 2 | Mini pandoro | price 6.00 | 400 g | 5 slices (estimated at 1 per 80 g) | 1.20 per slice | 1.50 per 100 g | does not fit: too few slices\noption 3 | Gingerbread loaf | price 8.00 | 600 g | 8 slices (given) | 1.00 per slice | 1.33 per 100 g | does not fit: too few slices\nfitting order (cheapest per slice first): none\nverdict: nothing-fits\npick: none\nrunner-up: none\nclosest: option 3 | Gingerbread loaf",
 "notes": "option 1 | slow-proofed, lemon zest, sold at the market stall\noption 2 | none\noption 3 | spiced, sticky top"
}

{
 "task": "compare",
 "verdict": "nothing-fits",
 "pick": "",
 "headline": "Gingerbread loaf comes closest but has only 8 slices, short of the 10 needed.",
 "rows": [
  {
   "option": "Bakery panettone",
   "taste": "Slow-proofed with lemon zest, sold at the market stall.",
   "wishes": [
    "unknown",
    "misses"
   ],
   "best_for": "Has the most slices on the shelf, 12.",
   "watch_out": "Costs €28.00, well over the €15.00 budget."
  },
  {
   "option": "Mini pandoro",
   "taste": "No notes given.",
   "wishes": [
    "unknown",
    "meets"
   ],
   "best_for": "Priced at €6.00, the lowest on the shelf.",
   "watch_out": "Only 5 slices, short of the 10 needed."
  },
  {
   "option": "Gingerbread loaf",
   "taste": "Spiced, with a sticky top.",
   "wishes": [
    "unknown",
    "meets"
   ],
   "best_for": "Priced at €8.00, well under 15.",
   "watch_out": "Only 8 slices, short of the 10 needed."
  }
 ],
 "pick_note": "Gingerbread loaf comes closest, with 8 slices against the 10 you need.",
 "closing": "You might look for a cake with closer to 10 slices."
}

{
 "task": "compare",
 "occasion": "just me and a pot of tea",
 "wishes": "none",
 "shelf": "currency: $\nbudget per cake: none\nslices needed: none\noption 1 | Panforte wedge | price 14.00 | 400 g | 5 slices (estimated at 1 per 80 g) | 2.80 per slice | 3.50 per 100 g | fits\noption 2 | Lebkuchen tin | price 11.00 | 500 g | 20 slices (given) | 0.55 per slice | 2.20 per 100 g | fits\nfitting order (cheapest per slice first): option 2, option 1\nverdict: clear-pick\npick: option 2 | Lebkuchen tin\nrunner-up: none\nclosest: none",
 "notes": "option 1 | dense, honey and almonds\noption 2 | soft spiced biscuits, some chocolate-coated"
}

{
 "task": "compare",
 "verdict": "clear-pick",
 "pick": "Lebkuchen tin",
 "headline": "Lebkuchen tin costs the least per slice among the cakes that fit.",
 "rows": [
  {
   "option": "Panforte wedge",
   "taste": "Dense, with honey and almonds.",
   "wishes": [],
   "best_for": "Dense cake with honey and almonds.",
   "watch_out": "Costs $2.80 per slice, more than Lebkuchen tin's $0.55."
  },
  {
   "option": "Lebkuchen tin",
   "taste": "Soft spiced biscuits, some chocolate-coated.",
   "wishes": [],
   "best_for": "Lowest price per slice of the fitting cakes, $0.55.",
   "watch_out": "No mark against this cake on the shelf."
  }
 ],
 "pick_note": "Lebkuchen tin costs $0.55 per slice, far less than Panforte wedge's $2.80, so it gives you the best value per slice for your tea.",
 "closing": "Peek at the label for almonds before you cut in."
}

const K = SliceKit;
const built = K.buildInput(K.form({ occasion: "a winter picnic", currency: "$", budget: 20, need: 8, wishes: ["no peel"],
  options: [{ name: "Tall panettone", price: 18, grams: 1000, slices: 12, notes: "raisins, no peel" },
            { name: "Spiced loaf", price: 9, grams: 700, slices: 0, notes: "" }] }));
built.input.shelf;                      // the page's lines: prices, fits, verdict and pick
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 shortlist")   // the comparison as Markdown

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

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

# input.json: the run input object - {"task": "compare", "occasion": "just me and a pot of tea", "wishes": "none", "shelf": "currency: $\nbudget per cake: none\n...\nverdict: clear-pick\npick: option 2 | Lebkuchen tin\n...", "notes": "option 1 | dense, honey and almonds\noption 2 | soft spiced biscuits, some chocolate-coated"}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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