Drive Do Not Dig Here from your own code

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

{"task": "carve", "title": "...", "draft_names_thing": true, "draft_says_where": true,
 "drift": [{"phrase": "...", "kind": "name | date | slang | shout | in-joke | brand", "swap": "..."}],
 "verdict": "fresh | durable | patch | recarve", "verdict_reason": "...",
 "level1": "...", "level2": "...", "level3": {"what": "...", "where": "...", "when": "...", "why": "..."}, "level4": "...",
 "pictograms": [{"id": "face | hand | lid | rays | nose | knot | door | walk | eye | suns | fire | spike", "why": "..."}],
 "kid_line": "...", "misreading": "..."}

{
 "task": "carve",
 "thing": "A takeaway tub of curry",
 "where": "The bottom shelf of the fridge, behind the pickle jar",
 "sealed": "August 2026",
 "danger": "The lid bulges and the smell clears the kitchen when anyone lifts it.",
 "wish": "Carry it to the outside bin without opening it.",
 "tone": "deadpan",
 "horizon": "10,000 years",
 "draft": "DO NOT open Dave's curry from August!! Trust me. Ask Priya if unsure lol",
 "drift_scan": "1 | DO NOT | shout\n2 | Dave's | name\n3 | August | date\n4 | !! | shout\n5 | Trust me | in-joke\n6 | Priya | name\n7 | lol | slang"
}

{
 "task": "carve",
 "title": "The Curry That Must Never Be Opened",
 "draft_names_thing": true,
 "draft_says_where": false,
 "drift": [
  {
   "phrase": "DO NOT",
   "kind": "shout",
   "swap": "do not open, in plain letters"
  },
  {
   "phrase": "Dave's",
   "kind": "name",
   "swap": "someone who lived here"
  },
  {
   "phrase": "August",
   "kind": "date",
   "swap": "2026"
  },
  {
   "phrase": "!!",
   "kind": "shout",
   "swap": "a plain full stop"
  },
  {
   "phrase": "Trust me",
   "kind": "in-joke",
   "swap": "leave it out"
  },
  {
   "phrase": "Priya",
   "kind": "name",
   "swap": "someone else"
  },
  {
   "phrase": "lol",
   "kind": "slang",
   "swap": "leave it out"
  }
 ],
 "verdict": "recarve",
 "verdict_reason": "The draft never says where the tub is kept, so it cannot stand alone as the marker.",
 "level1": "People sealed this. It is not good.",
 "level2": "If this is opened, the lid bulges and the smell clears the kitchen. Keep it closed and do not open it.",
 "level3": {
  "what": "A takeaway tub of curry, sealed shut.",
  "where": "Bottom shelf of a cold box for food, a fridge, behind a pickle jar.",
  "when": "Sealed in August 2026.",
  "why": "The lid bulges and the smell clears the kitchen if lifted."
 },
 "level4": "A takeaway tub of curry was sealed here by the people who lived here. It sits on the bottom shelf of a cold box for food, a fridge, behind a pickle jar. It was sealed in August 2026. The lid bulges and the smell clears the kitchen when anyone lifts it. Do not open it. Carry it to the outside bin without opening it.",
 "pictograms": [
  {
   "id": "face",
   "why": "Something here is clearly wrong, shown by the bulging lid."
  },
  {
   "id": "lid",
   "why": "The tub must stay closed to keep the bad smell inside."
  },
  {
   "id": "nose",
   "why": "Opening it lets a strong smell fill the whole kitchen."
  },
  {
   "id": "suns",
   "why": "This warning must keep working for a very long stretch of time."
  }
 ],
 "kid_line": "Please do not open the tub in the fridge. Just leave it there.",
 "misreading": "A finder might think something bad and smelly was sealed because people dreaded it and wanted it kept shut for a very long time."
}

{
 "task": "carve",
 "thing": "A drawer of tangled charger cables",
 "where": "The kitchen drawer under the toaster",
 "sealed": "2019",
 "danger": "Pull one cable and the whole knot comes out with it, and it takes an hour to put back.",
 "wish": "Close it again and leave the knot alone.",
 "tone": "solemn",
 "horizon": "1,000 years",
 "draft": "Knotted cables in this kitchen drawer under the toaster. Pull one and all of them come out. Keep it shut.",
 "drift_scan": "(none)"
}

{
 "task": "carve",
 "title": "The Cable Knot That Must Not Be Freed",
 "draft_names_thing": true,
 "draft_says_where": true,
 "drift": [],
 "verdict": "durable",
 "verdict_reason": "No phrase in the draft depends on a name, date, slang, shout, or shared memory, so nothing needs to be recarved.",
 "level1": "People sealed this, and it is not good.",
 "level2": "Pulling a cable drags the whole tangle out, and it is slow to undo. Leave it closed.",
 "level3": {
  "what": "A drawer of tangled charger cables.",
  "where": "The kitchen drawer under the toaster.",
  "when": "Sealed in 2019.",
  "why": "Pulling a cable drags the whole tangle out, and it is slow to fix."
 },
 "level4": "Here is a drawer of tangled charger cables, kept in the kitchen drawer under the toaster. It was sealed in 2019. Do not open it. Pulling a cable draws the whole tangle out with it, and setting it right again takes a long time. Close the drawer again, and leave the knot alone: this is what was asked. Nothing more about this is written. Let it remain closed and undisturbed.",
 "pictograms": [
  {
   "id": "face",
   "why": "Opening the drawer causes a tangle that takes a long time to undo."
  },
  {
   "id": "knot",
   "why": "The cables inside are tangled, and pulling any of them drags the rest loose."
  },
  {
   "id": "lid",
   "why": "Closing the drawer again and leaving it alone is what should happen."
  },
  {
   "id": "suns",
   "why": "This marker must stay clear and true for a very long time."
  }
 ],
 "kid_line": "Please leave this drawer shut and do not pull on any cables.",
 "misreading": "Reading only that people sealed something bad, saw a tangled knot, a shut lid, and endless suns, a finder might conclude a dangerous beast was imprisoned for all time."
}

{
 "task": "carve",
 "thing": "A jar of pickled chillies",
 "where": "The top shelf of the pantry",
 "sealed": "2024",
 "danger": "Far too hot to eat. Everyone who tried one cried.",
 "wish": "(not given)",
 "tone": "frantic",
 "horizon": "100 years",
 "draft": "Pickled chillies on this top shelf. Too hot to eat. Opened once in 2024 and everyone cried. Keep the lid on.",
 "drift_scan": "1 | 2024 | date"
}

{
 "task": "carve",
 "title": "The Chilli Jar That Must Stay Shut",
 "draft_names_thing": true,
 "draft_says_where": true,
 "drift": [
  {
   "phrase": "2024",
   "kind": "date",
   "swap": "the year it was sealed"
  }
 ],
 "verdict": "patch",
 "verdict_reason": "One phrase, the year, will not survive; everything else in the draft can stay.",
 "level1": "People sealed something here. It is not good.",
 "level2": "It is far too hot to eat and will make you cry if you try it. Keep it closed.",
 "level3": {
  "what": "A jar of pickled chillies.",
  "where": "The top shelf of the pantry.",
  "when": "Sealed in 2024.",
  "why": "Far too hot to eat. Everyone who tried one cried."
 },
 "level4": "Do not open this. Do not open it. A jar of pickled chillies sits on the top shelf of the pantry. It was sealed in 2024. It is far too hot to eat. Everyone who tried one cried. Leave it closed. Do not open it. Leave it closed. It must stay closed. Leave it closed.",
 "pictograms": [
  {
   "id": "face",
   "why": "Something sealed here is bad and far too hot to eat."
  },
  {
   "id": "lid",
   "why": "The jar was sealed and should stay closed."
  },
  {
   "id": "fire",
   "why": "The chillies inside are far too hot to eat."
  },
  {
   "id": "hand",
   "why": "Tasting it made everyone who tried it cry."
  }
 ],
 "kid_line": "It is too hot. Please do not open it. Leave it closed.",
 "misreading": "A future finder might think people sealed something here because it is a dreaded, burning, untouchable thing that must stay shut and is simply not good."
}

{
 "task": "carve",
 "thing": "A box of my teenage diaries",
 "where": "The attic, behind the water tank",
 "sealed": "2009",
 "danger": "Deeply embarrassing poems about a band I loved.",
 "wish": "Leave it closed. If you must move it, do not read it.",
 "tone": "solemn",
 "horizon": "10,000 years",
 "draft": "(no draft)",
 "drift_scan": "(no draft)"
}

{
 "task": "carve",
 "title": "The Diaries That Must Never Reopen",
 "draft_names_thing": false,
 "draft_says_where": false,
 "drift": [],
 "verdict": "fresh",
 "verdict_reason": "There was no draft to check, so this marker is carved straight from the facts given.",
 "level1": "People sealed this. It is not good.",
 "level2": "Inside are poems that would deeply embarrass the person who sealed it. Keep this closed.",
 "level3": {
  "what": "A box of teenage diaries.",
  "where": "The attic, behind the water tank.",
  "when": "Sealed in 2009.",
  "why": "Poems that deeply embarrass the person who sealed it."
 },
 "level4": "Here, behind the water tank in the attic, lies a box of teenage diaries, sealed in 2009. Inside are poems that would deeply embarrass the person who sealed it, written about a band once loved. The person who sealed it asked that this remain closed, and that if it must ever be moved, no one read what is inside. That is all that is known and all that is asked. Let it stay as it was sealed.",
 "pictograms": [
  {
   "id": "face",
   "why": "This box holds something that would deeply embarrass the person who sealed it."
  },
  {
   "id": "lid",
   "why": "The wish is for this box to stay closed."
  },
  {
   "id": "eye",
   "why": "The person who sealed it asked that no one read what is inside."
  },
  {
   "id": "suns",
   "why": "This marker needs to make sense for a very long time."
  }
 ],
 "kid_line": "Leave the box alone. Do not open it or look inside.",
 "misreading": "Seeing only that people sealed something bad, a dreading face, a shut lid, a closed eye and endless suns, a finder might guess this seals away a monster for all eternity."
}

const K = MarkKit;
const form = K.form({ thing: "A jar of pickled chillies", where: "The top shelf of the pantry", year: "2024",
  danger: "Far too hot to eat.", tone: "frantic", horizon: "100", draft: "Too hot. Opened once in 2024. Keep the lid on." });
K.scan(form.draft);                              // [{n: 1, phrase: "2024", kind: "date", start: 23}]
const built = K.buildInput(form);
built.provisional;                               // {verdict: "", why: "1 phrase flagged so far; ..."}
const wire = K.toWire(built.input);              // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// K.check(reply, built).notes                   // the page's re-check of the carving
// K.md(built, reply)                            // the marker as Markdown

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

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

# input.json: the run input object - {"task": "carve", "thing": "A jar of pickled chillies", "where": "The top shelf of the pantry", "sealed": "2024", "danger": "Far too hot to eat.", "wish": "(not given)", "tone": "frantic", "horizon": "100 years", "draft": "(no draft)", "drift_scan": "(no draft)"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="do-not-dig-here:carve:$(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: do-not-dig-here:carve:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json