Drive Twelve Each from your own code

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

{
 "task": "rule",
 "zone": "Hall closet",
 "today": "2026-10-19",
 "items": "[{\"id\":\"I1\",\"text\":\"Winter coat - wore it last winter\",\"qty\":1,\"facts\":[\"recent\"],\"bin\":\"keep\",\"by\":\"page\",\"page_why\":\"In use.\"},{\"id\":\"I2\",\"text\":\"Kids' snow boots x2, outgrown\",\"qty\":2,\"facts\":[\"nofit\"],\"bin\":\"donate\",\"by\":\"page\",\"page_why\":\"It does not fit or suit you - it may suit someone else.\"},\"... 14 more cards\"]",
 "ask": "[\"I1\",\"I2\",\"I3\",\"I4\",\"I5\",\"I6\",\"I7\",\"I8\",\"I9\",\"I10\",\"I11\",\"I12\",\"I13\",\"I14\",\"I15\",\"I16\"]",
 "counts": "{\"toss\":9,\"donate\":23,\"rehome\":2,\"keep\":3,\"hold\":1,\"stuck\":3,\"target\":12}",
 "goal": "Winter is coming and I need room for the coats and boots we actually wear. Two kids, one closet."
}

{
 "task": "rule",
 "title": "Hall Closet: Room For The Coats You Wear",
 "summary": "After these rulings, toss sits at 9 of the 12 target (short by 3) and rehome at just 2 of 12 (short by 10, since almost nothing here actually belongs somewhere else) - donate has already passed its mark at 23, mostly the fourteen tote bags and five spare umbrellas. The biggest win is clearing those duplicates along with the outgrown kids' boots and the too-small ski jacket, freeing real space for the coats and boots you still wear. Grandma's scarf, last year's costume, the extension cord, and the unmatched vacuum attachments go in the hold box; the fire extinguisher and winter car kit stay put as safety items.",
 "rulings": [
  {
   "id": "I1",
   "bin": "keep",
   "why": "You wore this coat last winter, so it is in use.",
   "guard": "",
   "rehome_to": "",
   "hold_days": null,
   "cite": [
    "I1"
   ]
  },
  {
   "id": "I2",
   "bin": "donate",
   "why": "The kids have outgrown these, so a child who still fits them can use them.",
   "guard": "",
   "rehome_to": "",
   "hold_days": null,
   "cite": [
    "I2",
    "N-goal"
   ]
  },
  {
   "id": "I3",
   "bin": "toss",
   "why": "Seven single gloves with no pairs left - nobody else can use them either.",
   "guard": "",
   "rehome_to": "",
   "hold_days": null,
   "cite": [
    "I3"
   ]
  },
  "..."
 ],
 "second_looks": [],
 "first_fifteen": [
  "Bag the 7 single gloves and 2 broken umbrellas for the trash.",
  "Box the 14 tote bags, 5 extra umbrellas, outgrown snow boots, too-small ski jacket, and old ice skates for donation.",
  "Carry the rain boots to the mudroom and the casserole dish back to the neighbor.",
  "..."
 ],
 "dont_buy": "Clearing nine toss items and twenty-three donations should free enough space in the one closet - no new bins or shelving needed.",
 "caveats": [
  "This rules only on what the lines say, not the physical condition of each item.",
  "The vacuum attachments are held rather than donated in case the matching vacuum turns up - check before deciding."
 ]
}

{
 "task": "rule",
 "zone": "Garage shelf",
 "today": "2026-10-19",
 "items": "[{\"id\":\"I1\",\"text\":\"Paint cans x4 - dried out\",\"qty\":4,\"facts\":[\"worn\",\"dup\"],\"bin\":\"toss\",\"by\":\"page\",\"page_why\":\"Broken or worn out - nobody else can use it either.\"},{\"id\":\"I2\",\"text\":\"Drill - borrowed from my neighbor Sam\",\"qty\":1,\"facts\":[\"borrowed\"],\"bin\":\"rehome\",\"by\":\"page\",\"page_why\":\"It belongs to your neighbor - give it back.\",\"owner\":\"neighbor\"},\"... 12 more cards\"]",
 "ask": "[\"I1\",\"I2\",\"I3\",\"I4\",\"I5\",\"I6\",\"I7\",\"I8\",\"I9\",\"I10\",\"I11\",\"I12\",\"I13\",\"I14\"]",
 "counts": "{\"toss\":11,\"donate\":6,\"rehome\":2,\"keep\":2,\"hold\":0,\"stuck\":4,\"target\":12}"
}

{
 "task": "rule",
 "title": "Garage Shelf: Toss Hits Twelve, Rehome Lags",
 "summary": "Toss already hits its twelve - the dried-out paint, the cracked cooler, the two dead light strands, and the router's box and manual add up to 12 - the biggest win on this shelf. Donate sits at 6 of 12, six short, and rehome at 2 of 12, ten short, so there's more sorting ahead once everything else is settled. The floor tiles, the mystery screws, and the old license plates have no evidence either way, so they go in a dated hold box instead of a guess. The first-aid kit stays guarded in keep as a safety item - replace it, then dispose of the expired one safely.",
 "rulings": [
  {
   "id": "I1",
   "bin": "toss",
   "why": "Dried-out paint can't be donated or recycled as ordinary trash - it needs a hazardous-waste drop-off.",
   "guard": "",
   "rehome_to": "",
   "hold_days": null,
   "cite": [
    "I1"
   ]
  },
  {
   "id": "I2",
   "bin": "rehome",
   "why": "It's borrowed from neighbor Sam, not yours to keep - give it back.",
   "guard": "",
   "rehome_to": "Sam",
   "hold_days": null,
   "cite": [
    "I2"
   ]
  },
  {
   "id": "I3",
   "bin": "donate",
   "why": "Never used, so someone else can get the use out of it.",
   "guard": "",
   "rehome_to": "",
   "hold_days": null,
   "cite": [
    "I3"
   ]
  },
  "..."
 ],
 "second_looks": [],
 "first_fifteen": [
  "Bag the cracked cooler and the two dead light strands for the trash.",
  "Carry the drill back to Sam.",
  "Set the car wax back in the shed.",
  "..."
 ],
 "dont_buy": "Once these items clear the shelf there's space to spare, so skip buying any new bins or organizers.",
 "caveats": [
  "This rules only on what the lines say - check local hazardous-waste rules for the paint and e-waste rules for the lights before tossing them.",
  "Keep the old first-aid kit in place until its replacement is actually in hand, not just on order."
 ]
}

{
 "task": "rule",
 "zone": "Junk and memory drawer",
 "today": "2026-10-19",
 "items": "[{\"id\":\"I1\",\"text\":\"Grandpa's pocket watch - doesn't work\",\"qty\":1,\"facts\":[\"worn\",\"sentimental\"],\"bin\":\"toss\",\"by\":\"you\"},{\"id\":\"I2\",\"text\":\"Birth certificate copy\",\"qty\":1,\"facts\":[\"record\"],\"bin\":\"toss\",\"by\":\"you\"},\"... 11 more cards\"]",
 "ask": "[\"I3\",\"I4\",\"I5\",\"I7\",\"I8\",\"I9\",\"I10\",\"I11\",\"I12\",\"I13\"]",
 "counts": "{\"toss\":31,\"donate\":19,\"rehome\":0,\"keep\":2,\"hold\":71,\"stuck\":1,\"target\":12}",
 "goal": "I want the drawer to close. I already threw a few things in the toss pile."
}

{
 "task": "rule",
 "title": "Drawer Clears Out, Memories Wait",
 "summary": "Toss ends up well past its twelve at 50 items once the instruction manuals, takeout menus, dead phones, dried-out pens and old batteries join it, while donate and rehome both sit at zero - twelve short each, since nothing here turned out to be truly donatable or belongs to another room. The biggest win is clearing all of that out without touching anything load-bearing. Sentimental keepsakes - the birthday cards, the kids' art, grandpa's watch - and both records - the birth certificate and the fridge warranty - are boxed on hold rather than removed, and the spare keys stay in keep as a safety item.",
 "rulings": [
  {
   "id": "I3",
   "bin": "hold",
   "why": "These 40 birthday cards are a sentimental duplicate, so they're boxed for now - keep a few favourites and photograph the rest.",
   "guard": "sentimental",
   "rehome_to": "",
   "hold_days": 30,
   "cite": [
    "I3"
   ]
  },
  {
   "id": "I4",
   "bin": "hold",
   "why": "This warranty is for a fridge you've already sold, but it's still a record, so it's boxed until you check how long this kind of paper should be kept.",
   "guard": "record",
   "rehome_to": "",
   "hold_days": 30,
   "cite": [
    "I4"
   ]
  },
  {
   "id": "I5",
   "bin": "toss",
   "why": "Three dead phones are broken and unusable by anyone else - they go to e-waste recycling.",
   "guard": "",
   "rehome_to": "",
   "hold_days": null,
   "cite": [
    "I5"
   ]
  },
  "..."
 ],
 "second_looks": [
  {
   "id": "I1",
   "to": "hold",
   "why": "Grandpa's watch is sentimental even though it's broken - worth boxing instead of tossing it outright.",
   "cite": [
    "I1"
   ]
  },
  {
   "id": "I2",
   "to": "hold",
   "why": "A birth certificate copy is a record, so it deserves a hold to check what's needed before it goes, not a straight toss.",
   "cite": [
    "I2"
   ]
  }
 ],
 "first_fifteen": [
  "Bag the 3 dead phones for e-waste recycling.",
  "Recycle the 9 instruction manuals and 10 takeout menus.",
  "Sort the 25 pens, toss the dried-out ones, and drop the loose batteries at a hazardous-waste collection point.",
  "..."
 ],
 "dont_buy": "Once the manuals, menus, pens, phones and batteries clear out, the drawer should close on its own - no new bin or organiser needed.",
 "caveats": [
  "This reads only the lines you entered, not what's actually inside each hold box.",
  "Check local rules before dropping off batteries, phones or paint.",
  "How long to keep the fridge warranty depends on where you live - check before shredding it."
 ]
}

const B = BinKit;
const st = B.state({
  zone: "Hall closet",
  list: "Umbrellas x5\nRain boots - belongs in the mudroom\nGrandma's scarf\nExtension cord, might need it",
  goal: "Room for the winter coats.",
  placed: {}                        // { "line text, lowercased": { bin: "keep", by: "you" } }
}, 2026);
const { input } = B.buildInput(st, { today: "2026-10-19" });
const wire = B.toWire(input);       // POST this to /estimate and /run
// later: const reply = B.normalizeRule(B.parseReply(job.output.output));
// const { moves, notes, after } = B.plan(reply, st, "2026-10-19");

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

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

# input.json: the run input object - {"task": "rule", "zone": "...", "today": "2026-10-19", "items": "[...]", "ask": "[...]", "counts": "{...}", "goal": "..."}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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