Drive Thirty-Six from your own code

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

{
 "task": "plan",
 "outing": "A Saturday afternoon walk with my sister through the park when the maples turn, a stop at the lakeside cafe, and back home as the sun goes down. I want it to feel warm and a bit nostalgic, like old family snapshots.",
 "iso": 200,
 "film_type": "color",
 "frames": 24,
 "camera": "Point-and-shoot compact",
 "camera_spec": "f/3.5-f/16, 1/2 s to 1/500 s, hand-held to 1/30 s, flash GN 10, automatic exposure",
 "shots": "G1 | 6 | Trail under the maples | Hazy sun, soft shadows | Landscape or skyline | Still subject\nG2 | 6 | Portraits in the leaves | Open shade or heavy overcast | Close, about 1.5 m | People, moving a little\nG3 | 4 | Lake from the overlook | Cloudy bright | Landscape or skyline | Still subject\nG4 | 4 | Coffee cup by the cafe window | Indoors by a bright window | Close, about 1.5 m | Still subject\nG5 | 4 | Walking home into the low sun | Golden hour, low sun | Across a table, about 3 m | People, moving a little",
 "facts": "[{\"id\": \"F-film\", \"text\": \"ISO 200 colour negative, 24 exposures; this page assumes it holds detail from 1 stop under to 3.5 stops over (estimate)\"}, {\"id\": \"F-camera\", \"text\": \"Point-and-shoot compact: f/3.5 to f/16, 1/2 s to 1/500 s, slowest hand-held 1/30 s, sets exposure itself; flash guide number 10 at ISO 100, so it reaches about 4 m on this film (typical specs, estimates)\"}, {\"id\": \"F-budget\", \"text\": \"Shots planned: 24 frames; the roll holds 24 - exactly full\"}, \"... 7 more facts\"]"
}

{
 "task": "plan",
 "verdict": "ready",
 "verdict_why": "Every group on this roll exposes on its own with no flash needed, none are risky or lost, and the planned frames add up to exactly the roll's length, so the plan can be shot as written.",
 "title": "Maple Walk With Sister",
 "groups": [
  {
   "id": "G1",
   "frames": 6,
   "mark": "maybe",
   "composition": "Let the trail lead the eye straight back into the trees, and put a cluster of bright turned leaves against the darker trunks so the color stands out. Tip the camera down a little so the path fills the bottom third and keep the flat sky out of the top of the frame.",
   "exposure": "The hazy sun gives soft, even light the camera reads correctly on its own - no flash, just hold the camera level and still.",
   "cite": [
    "F-G1"
   ]
  },
  {
   "id": "G2",
   "frames": 6,
   "mark": "keeper",
   "composition": "Get close enough that your sister's face and shoulders fill the frame, with a soft backdrop of leaves behind her rather than centered in open space. Have her turn toward the open part of the frame so there's room for her to look into.",
   "exposure": "The open shade is soft and even and the camera handles it on its own - no flash, just brace a little since people are moving.",
   "cite": [
    "F-G2"
   ]
  },
  "... 3 more"
 ],
 "swaps": [],
 "film_advice": "Keep this film - every shot on the roll exposes within its range as planned, and no other film speed would save more frames with this camera.",
 "tips": [
  "Wind on fully right after each shot so you don't miss the next one.",
  "Brace the camera against something solid for the café window shot - that one uses a slow shutter speed.",
  "... 2 more"
 ],
 "caveats": [
  "These exposures are rule-of-thumb estimates for typical light; an unusually dim café window could need the flash after all."
 ]
}

{
 "task": "plan",
 "outing": "Our Halloween house party. Everyone dresses up, we do a costume parade down the block in the late afternoon, then it is music and snacks inside with the lights low. I bought one single-use camera with 27 shots and I want the whole night on it, especially one photo of all twelve of us.",
 "iso": 400,
 "film_type": "color",
 "frames": 27,
 "camera": "Single-use camera",
 "camera_spec": "fixed f/11, 1/125 s, flash GN 14",
 "shots": "G1 | 10 | Costume close-ups at the party | Dim party or bar | Close, about 1.5 m | People, moving a little\nG2 | 8 | Porch and carved pumpkins before dark | Hazy sun, soft shadows | Across a table, about 3 m | Still subject\nG3 | 8 | Whole group across the living room | Dim party or bar | Across a room, about 6 m | People, moving a little\nG4 | 6 | Costume parade down the street | Cloudy bright | Across a table, about 3 m | People, moving a little",
 "facts": "[{\"id\": \"F-film\", \"text\": \"ISO 400 colour negative, 27 exposures; this page assumes it holds detail from 1 stop under to 3.5 stops over (estimate)\"}, {\"id\": \"F-camera\", \"text\": \"Single-use camera: fixed f/11 and 1/125 s; flash guide number 14 at ISO 100, so it reaches about 2.5 m on this film (typical specs, estimates)\"}, {\"id\": \"F-budget\", \"text\": \"Shots planned: 32 frames; the roll holds 27 - 5 frames over\"}, \"... 6 more facts\"]"
}

{
 "task": "plan",
 "verdict": "rebalance",
 "verdict_why": "You've planned 32 frames for a 27-exposure roll, 5 over, and the whole-group photo is lost at its planned distance because the flash can't reach that far. Nothing else would save more frames with this film, so the fix is trimming and moving people closer, not a different film speed.",
 "title": "Halloween House Party Roll",
 "groups": [
  {
   "id": "G1",
   "frames": 10,
   "mark": "keeper",
   "composition": "Let a costume detail - a mask, face paint, a prop - fill most of the frame, since that's where the eye should land first. Back the person against a plain wall or dark doorway so the costume stands out from the party clutter behind them.",
   "exposure": "Turn the flash on - at about 1.5m you're well inside its 2.5m reach, so it should expose fine in the dim light.",
   "cite": [
    "F-G1"
   ]
  },
  {
   "id": "G2",
   "frames": 2,
   "mark": "maybe",
   "composition": "Use a carved pumpkin's face as the eye-catcher in the foreground, set against the softer, out-of-focus porch behind it. Get down near pumpkin height so the carving looks back at the camera instead of down at it.",
   "exposure": "No flash needed - the hazy afternoon light is within the film's latitude even though it reads a touch bright.",
   "cite": [
    "F-G2"
   ]
  },
  "... 2 more"
 ],
 "swaps": [
  {
   "what": "Move the whole-group photo in close, within about the flash's reach, instead of shooting it across the room",
   "why": "At the planned distance the flash can't reach the group at all, so it's lost; this is the one shot the night is especially about, so it has to be fixable",
   "cite": [
    "F-G3",
    "F-camera",
    "N-outing"
   ]
  },
  {
   "what": "Cut the porch and pumpkin shots from 8 frames to 2",
   "why": "The roll is over by 5 frames as planned, and this group isn't part of what the person said the night is about",
   "cite": [
    "F-G2",
    "F-budget",
    "N-outing"
   ]
  },
  "... 1 more"
 ],
 "film_advice": "Keep this ISO 400 colour negative film - no other film speed would save more frames with this camera and this shot list.",
 "tips": [
  "Wind the film on fully after every shot - this camera won't fire right if it isn't advanced.",
  "Switch the flash on and give it a few seconds to charge before every shot indoors or after dark.",
  "... 2 more"
 ],
 "caveats": [
  "The flash's reach and the exposure calls here are rule-of-thumb estimates for a typical single-use camera, so real results may vary a little.",
  "Packing all twelve people within the flash's reach in a living room will be tight - you may need two close rows."
 ]
}

{
 "task": "plan",
 "outing": "A night out in the city: sunset drinks on a rooftop, a walk down the main street under the neon, a small club gig, then a late diner. I loaded the ISO 100 roll I had left from summer. I shoot hand-held and do not own a flash.",
 "iso": 100,
 "film_type": "color",
 "frames": 36,
 "camera": "Manual SLR or rangefinder",
 "camera_spec": "f/2-f/16, 1 s to 1/1000 s, hand-held to 1/30 s, no flash, manual exposure",
 "shots": "G1 | 12 | Neon signs and people on the main street | Lit street at night | Across a table, about 3 m | People, moving a little\nG2 | 12 | The band on stage | Lit stage or stadium at night | Across a room, about 6 m | Action or dancing\nG3 | 6 | Late diner booth after the show | Home lamps at night | Close, about 1.5 m | Still subject\nG4 | 6 | Rooftop at sunset before we go out | Golden hour, low sun | Landscape or skyline | Still subject",
 "facts": "[{\"id\": \"F-film\", \"text\": \"ISO 100 colour negative, 36 exposures; this page assumes it holds detail from 1 stop under to 3.5 stops over (estimate)\"}, {\"id\": \"F-camera\", \"text\": \"Manual SLR or rangefinder: f/2 to f/16, 1 s to 1/1000 s, slowest hand-held 1/30 s, set by hand; no flash (typical specs, estimates)\"}, {\"id\": \"F-budget\", \"text\": \"Shots planned: 36 frames; the roll holds 36 - exactly full\"}, \"... 6 more facts\"]"
}

{
 "task": "plan",
 "verdict": "wrong-film",
 "verdict_why": "More than half of the planned frames are risky or lost on this film speed once it is dark out, because the street and stage scenes are too dim for it without a flash. A faster film would turn nearly all of those same frames into clean exposures, so the film itself is the problem here, not the shot list.",
 "title": "City Night Out",
 "groups": [
  {
   "id": "G1",
   "frames": 12,
   "mark": "keeper",
   "composition": "Let the neon signs supply the light and colour, and let the people read as dark, simple shapes against them - figure against a glowing ground. Keep the frame tight so a sign's glow sits just over a shoulder, not behind a face, and have them pause a beat so their outline stays sharp while the street can blur a touch around them.",
   "exposure": "On this film the street light is well below what the film can hold, so the frame would come out too dark to see; the faster film is the fix, pulling this one back into a shot that actually prints.",
   "cite": [
    "F-G1"
   ]
  },
  {
   "id": "G2",
   "frames": 12,
   "mark": "keeper",
   "composition": "Put the performer under the single brightest stage light and let the dark room swallow everything else - that is the figure against the ground here. Keep mic stands and gear out of the edges, move in or zoom with your feet until they fill a third of the frame, and catch them on the brief pause at the top of a move to cut down blur.",
   "exposure": "At this speed the stage shot is under the film's range enough to look thin and muddy in the shadows, though it may still come out; the faster film gives this one a clean negative instead of a gamble.",
   "cite": [
    "F-G2"
   ]
  },
  "... 2 more"
 ],
 "swaps": [
  {
   "what": "reload with a faster, ISO 400 colour negative film for the rest of the night",
   "why": "the same shot list on this faster film turns almost every street and stage frame into a clean exposure instead of a dark or thin one",
   "cite": [
    "F-best-iso"
   ]
  }
 ],
 "film_advice": "This ISO 100 roll is the problem tonight, not the plan. An ISO 400 colour negative film suits this camera and this much after-dark shooting far better, and would save nearly all the shots that are currently dark or thin.",
 "tips": [
  "This camera has no flash, so get physically close to whatever light there is rather than relying on it to reach you.",
  "Brace against a wall, railing or table for anything shot at a slow hand-held speed so the frame does not blur.",
  "... 2 more"
 ],
 "caveats": [
  "If this roll gets shot on the ISO 100 film anyway, expect the street walk to come out too dark to print and the stage shots to look thin and grainy."
 ]
}

const K = RollKit;
const roll = K.sanitize({ iso: 400, filmType: "color", frames: 27, camera: K.presetCamera("disposable"),
  groups: K.parseShots("10 | Costume close-ups | party | near | people\n8 | Whole group | party | far | people").groups });
const { input } = K.buildInput(roll, "Our Halloween house party");
const wire = K.toWire(input);        // POST this to /estimate and /run
// later: const n = K.normalize(K.parseReply(job.output.output));
// const { alloc, notes } = K.checkPlan(n, roll);  K.applyPlan(roll, n) -> the roll with the new counts

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

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

# input.json: the run input object - {"task": "plan", "outing": "...", "iso": 400, "film_type": "color", "frames": 27, "camera": "Single-use camera", "camera_spec": "fixed f/11, 1/125 s, flash GN 14", "shots": "G1 | 10 | Costume close-ups | ...\n...", "facts": "[...]"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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