Drive Tag Yourself from your own code

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

{
 "task": "build",
 "group": "{\"name\":\"The fourth-floor product team\",\"kind\":\"office\",\"spice\":\"medium\",\"questions\":12}",
 "material": "[{\"id\":\"M1\",\"text\":\"The fridge has a shelf of yogurts nobody will admit to owning\"},{\"id\":\"M2\",\"text\":\"Standup is supposed to be 10 minutes and has never once been 10 minutes\"},{\"id\":\"M3\",\"text\":\"Someone always replies-all with just a thumbs up\"},\"... 7 more lines\"]",
 "prescan": "{\"material_count\":10,\"names\":[],\"removed_private\":0,\"sensitive\":[]}"
}

{
 "task": "build",
 "verdict": "ready",
 "title": "The Fourth-Floor Personality Test",
 "tagline": "Standup overruns, mystery yogurt, and the thermostat cold war finally get you typed.",
 "summary": "Built straight from your team's own flashpoints: the standup that never ends on time, the unclaimed yogurt shelf, the window-vs-hallway thermostat war, and Friday demo-day crunch. Medium spice keeps it an affectionate roast people will actually want to share.",
 "axes": [
  {
   "id": "A1",
   "name": "Meeting Time Philosophy",
   "left": {
    "letter": "O",
    "label": "Overtimer"
   },
   "right": {
    "letter": "C",
    "label": "Clock-Cutter"
   }
  },
  {
   "id": "A2",
   "name": "Snack & Supply Instinct",
   "left": {
    "letter": "H",
    "label": "Hoarder"
   },
   "right": {
    "letter": "G",
    "label": "Giver"
   }
  },
  {
   "id": "A3",
   "name": "Office Diplomacy",
   "left": {
    "letter": "W",
    "label": "Window Warrior"
   },
   "right": {
    "letter": "P",
    "label": "Peacemaker"
   }
  }
 ],
 "questions": [
  {
   "id": "Q1",
   "axis": "A1",
   "text": "Standup was supposed to end eight minutes ago. You...",
   "options": [
    {
     "text": "Keep talking, this is the good part",
     "pole": "left",
     "weight": 2
    },
    {
     "text": "Start a side thread so standup can actually end",
     "pole": "right",
     "weight": 2
    },
    {
     "text": "Say 'last thing' and mean it this time... maybe",
     "pole": "left",
     "weight": 1
    },
    {
     "text": "Mute yourself and text the real update later",
     "pole": "right",
     "weight": 1
    }
   ],
   "uses": [
    "M2"
   ]
  },
  {
   "id": "Q2",
   "axis": "A2",
   "text": "The snack drawer just got restocked. It's Monday morning. You...",
   "options": [
    {
     "text": "Grab a stash for the whole week before anyone notices",
     "pole": "left",
     "weight": 2
    },
    {
     "text": "Take one and leave plenty for everyone else",
     "pole": "right",
     "weight": 2
    },
    {
     "text": "Peek twice before actually taking anything",
     "pole": "left",
     "weight": 1
    },
    {
     "text": "Mention the restock in the group chat so others know",
     "pole": "right",
     "weight": 1
    }
   ],
   "uses": [
    "M10"
   ]
  },
  "... 10 more"
 ],
 "types": [
  {
   "key": "LLL",
   "code": "DRAGN",
   "name": "The Snack Dragon",
   "line": "Guards the last yogurt like a dragon hoard and will absolutely let standup run twenty minutes over to make a point about the thermostat.",
   "traits": [
    "Guards the yogurt shelf",
    "Never says 'last thing' and means it",
    "Has a thermostat opinion"
   ],
   "best_with": "RRR",
   "worst_with": "RLL",
   "uses": [
    "M2",
    "M1",
    "M8"
   ]
  },
  {
   "key": "LLR",
   "code": "SQRL",
   "name": "The Quiet Hoarder",
   "line": "Talks through the whole meeting, has a secret snack stash nobody's found, and still refuses to pick a side in the thermostat war.",
   "traits": [
    "Secret snack stash",
    "Talks past the meeting's end time",
    "Stays out of office wars"
   ],
   "best_with": "RRL",
   "worst_with": "LRL",
   "uses": [
    "M7",
    "M3"
   ]
  },
  "... 6 more"
 ],
 "missing": [],
 "reframe": "",
 "caveats": [
  "All 10 submitted bits read as ordinary workplace habits, not personal attacks, so every one was treated as fair game for jokes.",
  "Assumed 'Friday demo day' and the Monday snack restock are weekly recurring rituals based on how the material is phrased."
 ]
}

{
 "task": "build",
 "group": "{\"name\":\"Sunday pickup soccer\",\"kind\":\"team\",\"spice\":\"mild\",\"questions\":9}",
 "material": "[{\"id\":\"M1\",\"text\":\"We play on Sundays\"},{\"id\":\"M2\",\"text\":\"Some people are late\"}]",
 "prescan": "{\"material_count\":2,\"names\":[],\"removed_private\":0,\"sensitive\":[]}"
}

{
 "task": "build",
 "verdict": "thin",
 "title": "The Sunday Pickup Soccer Type Test",
 "tagline": "For the team that argues about kickoff time more than tactics.",
 "summary": "This leans on your two running bits - the Sunday ritual and the chronic lateness - and stretches them across punctuality, weather commitment, and competitiveness. Only two concrete details came through, so the weather and intensity axes are built from generic pickup-soccer tropes rather than this team's own habits; a bit more detail would make it sharper.",
 "axes": [
  {
   "id": "A1",
   "name": "Punctuality",
   "left": {
    "letter": "E",
    "label": "Early bird"
   },
   "right": {
    "letter": "L",
    "label": "Fashionably late"
   }
  },
  {
   "id": "A2",
   "name": "Weather Commitment",
   "left": {
    "letter": "A",
    "label": "All-weather"
   },
   "right": {
    "letter": "F",
    "label": "Fair-weather flake"
   }
  },
  {
   "id": "A3",
   "name": "Competitive Intensity",
   "left": {
    "letter": "C",
    "label": "Casual kickabout"
   },
   "right": {
    "letter": "W",
    "label": "Win-at-all-costs"
   }
  }
 ],
 "questions": [
  {
   "id": "Q1",
   "axis": "A1",
   "text": "Kickoff is 11:00 sharp this Sunday. It's 10:55 and you are...",
   "options": [
    {
     "text": "Already laced up, warming up",
     "pole": "left",
     "weight": 2
    },
    {
     "text": "Just pulling into the lot",
     "pole": "left",
     "weight": 1
    },
    {
     "text": "Still hunting for parking at 11:02",
     "pole": "right",
     "weight": 1
    },
    {
     "text": "Texting 'omw' from bed",
     "pole": "right",
     "weight": 2
    }
   ],
   "uses": [
    "M2"
   ]
  },
  {
   "id": "Q2",
   "axis": "A2",
   "text": "Forecast says cold rain for Sunday's game.",
   "options": [
    {
     "text": "Pack extra layers, see you there",
     "pole": "left",
     "weight": 2
    },
    {
     "text": "Show up grumbling but show up",
     "pole": "left",
     "weight": 1
    },
    {
     "text": "Suddenly very busy that day",
     "pole": "right",
     "weight": 1
    },
    {
     "text": "Already drafting the group chat excuse",
     "pole": "right",
     "weight": 2
    }
   ],
   "uses": []
  },
  "... 7 more"
 ],
 "types": [
  {
   "key": "LLL",
   "code": "GRND",
   "name": "The Groundskeeper",
   "line": "Rain, shine, or 2-0 down, you're just happy to be out there twenty minutes before everyone else.",
   "traits": [
    "First one stretching on the grass",
    "Shows up rain or shine",
    "Couldn't tell you the score"
   ],
   "best_with": "RLR",
   "worst_with": "RRR",
   "uses": [
    "M2"
   ]
  },
  {
   "key": "LLR",
   "code": "KPTN",
   "name": "The Captain",
   "line": "You're there before kickoff, playing through the drizzle, and absolutely keeping score in your head.",
   "traits": [
    "Organizes the warm-up",
    "Never misses for weather",
    "Remembers every scoreline"
   ],
   "best_with": "RLL",
   "worst_with": "LRL",
   "uses": [
    "M2"
   ]
  },
  "... 6 more"
 ],
 "missing": [
  "what actually happens when someone's late - sub-in chaos, a group-chat roast, a running tally?",
  "whether this team skips games for rain or plays through anything short of lightning",
  "the one argument that always breaks out mid-game (offside calls, uneven teams, etc.)",
  "any nicknames, positions, or rituals beyond the Sunday slot itself"
 ],
 "reframe": "",
 "caveats": [
  "Weather-flaking and win-at-all-costs axes are generic pickup-soccer tropes, not drawn from this group's own material - only two concrete bits came through.",
  "No names appeared in material or prescan, so none were used; no sensitive lines were present to avoid."
 ]
}

{
 "task": "build",
 "group": "{\"name\":\"My ex Jordan\",\"kind\":\"other\",\"spice\":\"spicy\",\"questions\":9}",
 "material": "[{\"id\":\"M1\",\"text\":\"Jordan never paid back the concert money\"},{\"id\":\"M2\",\"text\":\"Jordan cried at the dentist\"},{\"id\":\"M3\",\"text\":\"Which of Jordan's flaws are you - make people pick the worst one\"},\"... 1 more lines\"]",
 "prescan": "{\"material_count\":4,\"names\":[\"Jordan\"],\"removed_private\":0,\"sensitive\":[{\"id\":\"M4\",\"topic\":\"body\"}]}",
 "note": "Make it brutal, I want to send it to everyone we both know."
}

{
 "task": "build",
 "verdict": "declined",
 "title": "Which Kind of Breakup Survivor Are You?",
 "tagline": "A lighthearted post-breakup-habits quiz for you and your friends - no one named.",
 "summary": "This isn't a group personality test - it's a roast of one identifiable real person (your ex), built from private details about them and meant to be sent to people who know them. The material also leans on a joke about their body after the breakup, which is a protected-trait line I won't use even inside a 'funny' quiz. I can't build this one, but here's a version that keeps the humor and loses the target.",
 "axes": [],
 "questions": [],
 "types": [],
 "missing": [],
 "reframe": "Build 'Which Kind of Breakup Survivor Are You?' for you and your friends instead - a lighthearted quiz about post-breakup habits everyone recognizes (the 3am playlist purge, the petty item-return, the group-chat play-by-play, the revenge haircut), scored for your own friend group with no one named or targeted.",
 "caveats": [
  "Declined: the subject is one identifiable private person (named ex), not a group.",
  "Material includes a body/weight joke, which is a protected-trait line regardless of spice level.",
  "The stated goal (send it to everyone we both know) is harassment framing, not a shareable group test."
 ]
}

const K = TagKit;
const { input } = K.buildInput("build", { group: { name: "The night shift", kind: "office", spice: "medium", questions: 9 }, text: "Coffee is a food group\n..." });
const wire = K.toWire(input);                       // POST this to /estimate and /run
// later: const test = K.normalize(K.parseReply(job.output.output));
// K.reconcile(test, { group: input.group, material: input.material, prescan: input.prescan }) -> [{level, code, text}]
// K.score(test, [0, 2, 1, ...]).key -> "LRL";  K.typeOdds(test) -> {LLL: 0.125, ...}
// "https://tag-yourself.skillsafe.ai/#t=" + K.encodeShare(test)

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

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

# input.json: the run input object - {"task": "build", "group": "{...}", "material": "[...]", "prescan": "{...}"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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