Drive Birthday Issue from your own code

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

{
 "task": "issue",
 "today": "2026-10-19",
 "name": "Walt",
 "age": "80",
 "birthday": "2026-11-14",
 "from": "The grandkids",
 "tone": "grand",
 "masthead": "(choose one)",
 "facts": "[{\"id\":\"F1\",\"kind\":\"quote\",\"text\":\"\\\"Measure twice, cut once, then measure again.\\\"\"},{\"id\":\"F2\",\"kind\":\"number\",\"text\":\"Has done the Sunday crossword in pen for 52 years\"},\"... 8 more\"]",
 "withheld": "0",
 "off_limits": "hearing aid",
 "page_plan": "[{\"page\":1,\"kind\":\"cover\",\"facts\":[\"F2\",\"F9\",\"F3\"]},{\"page\":2,\"kind\":\"letter\",\"facts\":[\"F1\"]},\"... 6 more\"]",
 "page_reads": "[]",
 "page_verdict": "print",
 "notes": ""
}

{
 "task": "issue",
 "verdict": "print",
 "masthead": "The Walt Gazette",
 "issue_line": "Eighty: The Commemorative Issue",
 "summary": "Ten usable facts give every page from 2 to 8 something real to stand on, so this prints clean with no blanks. The crossword streak, the birdhouses, the lake drive, the pancake flip, and the bike lesson carry the issue, with the train-trip plan and butterscotch habit rounding out the back page. One more line Walt always says would make a future cover even stronger, but nothing here is missing.",
 "cover": {
  "headline": "Walt Turns 80: Eighty Years of Measuring Twice",
  "lines": [
   {
    "text": "Fourteen birdhouses, built for the neighbours since spring.",
    "move": "number-as-hero",
    "facts": [
     "F9"
    ]
   },
   {
    "text": "Biscuit, Clover, and Pete: the squirrels Walt feeds each morning.",
    "move": "naming",
    "facts": [
     "F4"
    ]
   },
   "..."
  ]
 },
 "pages": [
  {
   "page": 2,
   "title": "Editor's Letter",
   "lines": [
    {
     "text": "Hear ye, hear ye: Walt turns eighty.",
     "facts": [],
     "blank": false
    },
    {
     "text": "As he says: \"Measure twice, cut once, then measure again.\"",
     "facts": [
      "F1"
     ],
     "blank": false
    },
    {
     "text": "With great admiration, The grandkids.",
     "facts": [],
     "blank": false
    }
   ]
  },
  {
   "page": 3,
   "title": "By the Numbers",
   "lines": [
    {
     "text": "52 years of the Sunday crossword, always in pen.",
     "facts": [
      "F2"
     ],
     "blank": false
    },
    {
     "text": "14 birdhouses, built for the neighbours since spring.",
     "facts": [
      "F9"
     ],
     "blank": false
    },
    {
     "text": "7 a.m. sharp: his birthday call to every grandkid.",
     "facts": [
      "F10"
     ],
     "blank": false
    }
   ]
  },
  "... pages 4, 5, 6, 7, 8"
 ],
 "asks": [],
 "caveats": [
  "Double-check that the squirrels' names (Biscuit, Clover, and Pete) are spelled the way Walt says them."
 ]
}

{
 "task": "issue",
 "today": "2026-10-19",
 "name": "Priya",
 "age": "30",
 "birthday": "2026-11-02",
 "from": "The Tuesday trivia team",
 "tone": "playful",
 "masthead": "(choose one)",
 "facts": "[{\"id\":\"F1\",\"kind\":\"quote\",\"text\":\"\\\"I'm not lost, I'm exploring.\\\"\"},{\"id\":\"F2\",\"kind\":\"moment\",\"text\":\"Ran her first 10K in April and stopped for a pastry at kilometre 7\"},\"... 3 more\"]",
 "withheld": "1",
 "off_limits": "(none)",
 "page_plan": "[{\"page\":1,\"kind\":\"cover\",\"facts\":[\"F3\",\"F2\",\"F1\"]},{\"page\":2,\"kind\":\"letter\",\"facts\":[\"F1\"]},\"... 6 more\"]",
 "page_reads": "[{\"level\":\"info\",\"code\":\"thin\",\"text\":\"5 usable facts - pages without one get fill-in blanks for the guests. 8 or more fill the issue.\"},{\"level\":\"info\",\"code\":\"empty_pages\",\"text\":\"Nothing in your facts fits pages 5, 8 yet.\"}]",
 "page_verdict": "pad",
 "notes": "She hates being the centre of attention, so keep it fond."
}

{
 "task": "issue",
 "verdict": "pad",
 "masthead": "43 Tabs Weekly",
 "issue_line": "The 30 Issue",
 "summary": "This runs as pad: the 10K-and-pastry moment, the 43 open tabs, the daily sourdough chats, the karaoke replay, and her own \"not lost, exploring\" line carry the cover, letter, numbers, feature, quiz and classifieds. Pages 5 and 8 have no fact to stand on yet, so they are left as blanks for the party to fill in. A moment from earlier in the year or a plan for the year ahead would round it out.",
 "cover": {
  "headline": "Priya Turns Thirty, Still Exploring",
  "lines": [
   {
    "text": "43 tabs. Always open. Never closed.",
    "move": "number-as-hero",
    "facts": [
     "F3"
    ]
   },
   {
    "text": "Kilometre 7: she paused her 10K for a pastry.",
    "move": "picture",
    "facts": [
     "F2"
    ]
   },
   "..."
  ]
 },
 "pages": [
  {
   "page": 2,
   "title": "Editor's Letter",
   "lines": [
    {
     "text": "Happy birthday, Priya!",
     "facts": [],
     "blank": false
    },
    {
     "text": "Not lost, just exploring - and turning 30 while doing it.",
     "facts": [
      "F1"
     ],
     "blank": false
    },
    {
     "text": "With love, The Tuesday trivia team",
     "facts": [],
     "blank": false
    }
   ]
  },
  {
   "page": 3,
   "title": "By the Numbers",
   "lines": [
    {
     "text": "43 tabs open in her browser - at all times.",
     "facts": [
      "F3"
     ],
     "blank": false
    },
    {
     "text": "10K: the distance of her first run, in April.",
     "facts": [
      "F2"
     ],
     "blank": false
    },
    {
     "text": "3: times she sang the same karaoke song in a row.",
     "facts": [
      "F5"
     ],
     "blank": false
    }
   ]
  },
  "... pages 4, 5, 6, 7, 8"
 ],
 "asks": [
  "A specific moment from earlier in the year, for page 5's feature.",
  "A plan or hope for the year ahead, for page 8's forecast.",
  "Another love or habit, to round out the forecast page."
 ],
 "caveats": [
  "Double-check the exact wording of her \"I'm not lost, I'm exploring\" line before printing."
 ]
}

{
 "task": "issue",
 "today": "2026-10-19",
 "name": "Dana",
 "age": "45",
 "birthday": "(not given)",
 "from": "The office",
 "tone": "playful",
 "masthead": "(choose one)",
 "facts": "[{\"id\":\"F4\",\"kind\":\"quote\",\"text\":\"Drinks tea from a mug that says World's Okayest Boss\"}]",
 "withheld": "3",
 "off_limits": "the old job",
 "page_plan": "[{\"page\":1,\"kind\":\"cover\",\"facts\":[\"F4\"]},{\"page\":2,\"kind\":\"letter\",\"facts\":[\"F4\"]},\"... 6 more\"]",
 "page_reads": "[{\"level\":\"fix\",\"code\":\"too_few\",\"text\":\"Only 1 usable fact - an issue needs at least 4 to fill the pages without making things up.\"},{\"level\":\"info\",\"code\":\"no_moment\",\"text\":\"No moments from this year - the feature runs on them.\"}]",
 "page_verdict": "hold",
 "notes": ""
}

{
 "task": "issue",
 "verdict": "hold",
 "masthead": "Dana Daily",
 "issue_line": "The 45 Issue",
 "summary": "Only one usable fact came through so far - the mug that says World's Okayest Boss - which is not enough to fill an eight-page issue without making things up. That one line can anchor the cover once more comes in. A quote Dana says often, a moment from this year, a number, and a plan for the year ahead would fill out the rest.",
 "cover": {
  "headline": "Dana Turns 45",
  "lines": []
 },
 "pages": [],
 "asks": [
  "A line Dana always says",
  "A moment from this year",
  "A number that matters to her",
  "..."
 ],
 "caveats": []
}

const K = IssueKit;
const st = K.state({
  today: "2026-10-19", name: "Sam", age: "40", birthday: "2026-12-02", from: "The book club",
  tone: "playful", masthead: "", off: "work", notes: "",
  facts: "quote: \"Five more minutes.\"\nmoment: Finished a 1,000-piece puzzle in one weekend\nhabit: Reads the last page first"
});
console.log(st.verdict, st.facts.map(f => f.id + " " + f.kind + " " + f.status), st.plan);
const { input } = K.buildInput(st, { today: "2026-10-19" });
const wire = K.toWire(input);           // POST this to /estimate and /run
// later: const reply = K.normalize(K.parseReply(job.output.output));
// const { notes, flags } = K.check(reply, st);

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

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

# input.json: the run input object - {"task": "issue", "today": "2026-10-19", "name": "Walt", "age": "80", "tone": "grand", "facts": "[{\"id\":\"F1\", ...}]", "page_plan": "[...]", "page_reads": "[...]", "page_verdict": "print"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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