Drive Ten Arms from your own code

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

{"task": "search-plan", "summary": "...", "spots": [{"n": 1, "score": 0, "spot_it": "fair", "evidence": "...", "why": "...", "how_to_look": "..."}], "elsewhere": {"uncovered": ["..."], "why": "...", "retrace": "..."}, "closing": "..."}

{
 "task": "search-plan",
 "item": "house keys on a red fob",
 "last_seen": "I unlocked the front door with them when I got back from the shop",
 "since": "I put the shopping away in the kitchen, hung my coat on the hook and sat on the sofa with a cup of tea",
 "spots": "1. front door - note: I sometimes leave them in the lock\n2. key bowl by the door - note: where they are meant to live\n3. kitchen counter - note: where the shopping bags went\n4. coat pocket - note: the coat I wore to the shop\n5. sofa",
 "spot_count": "5",
 "facts": "spots listed: 5 (numbered 1 to 5); reply with exactly 5 spot entries in that order\nthe page adds its own share for somewhere not listed, from the uncovered steps\nchances are judged before any searching: ignore any searches the story says were already done - the page applies the person's search marks itself"
}

{
 "task": "search-plan",
 "summary": "Between unlocking the front door and sitting on the sofa, the story never says what became of the keys.",
 "spots": [
  {
   "n": 1,
   "score": 3,
   "spot_it": "fair",
   "evidence": "unlocked the front door with them",
   "why": "You used them to unlock this door, so they could be right here.",
   "how_to_look": "Check the lock and handle closely, and look along the bottom edge of the door."
  },
  {
   "n": 2,
   "score": 2,
   "spot_it": "easy",
   "evidence": "where they are meant to live",
   "why": "The keys are meant to live here, so they might simply be in this bowl.",
   "how_to_look": "Glance into the bowl and move anything inside it aside to see the bottom."
  },
  {
   "n": 3,
   "score": 1,
   "spot_it": "easy",
   "evidence": "put the shopping away in the kitchen",
   "why": "You put the shopping away in the kitchen, so the keys could have been set down here too.",
   "how_to_look": "Scan the whole counter surface, checking under anything sitting on it."
  },
  {
   "n": 4,
   "score": 1,
   "spot_it": "fair",
   "evidence": "hung my coat on the hook",
   "why": "You hung this coat on the hook, so the keys could still be in its pocket.",
   "how_to_look": "Reach all the way into the pocket and feel along the bottom seam."
  },
  {
   "n": 5,
   "score": 1,
   "spot_it": "hard",
   "evidence": "sat on the sofa",
   "why": "You sat on the sofa, so the keys could have been set down there too.",
   "how_to_look": "Check between and under the cushions and run a hand down the sides."
  }
 ],
 "elsewhere": {
  "uncovered": [],
  "why": "The steps after unlocking the door are all covered by the spots already listed, with nothing left outside them.",
  "retrace": "unlocked the front door then put the shopping away in the kitchen then hung your coat on the hook then sat on the sofa with a cup of tea"
 },
 "closing": "Take a calm look through each spot without rushing, and trust what turns up."
}

{
 "task": "search-plan",
 "item": "reading glasses in a brown case",
 "last_seen": "I had them on while reading in bed last night",
 "since": "this morning I made breakfast, had a shower and got dressed in the bedroom",
 "spots": "1. bed - note: the duvet is in a heap\n2. bedside table - note: where I usually put them\n3. bathroom shelf\n4. kitchen table - note: where I ate breakfast\n5. work bag - note: I packed it yesterday",
 "spot_count": "5",
 "facts": "spots listed: 5 (numbered 1 to 5); reply with exactly 5 spot entries in that order\nthe page adds its own share for somewhere not listed, from the uncovered steps\nchances are judged before any searching: ignore any searches the story says were already done - the page applies the person's search marks itself"
}

{
 "task": "search-plan",
 "summary": "Between reading in bed last night and starting your morning, your story does not say what happened to the glasses.",
 "spots": [
  {
   "n": 1,
   "score": 3,
   "spot_it": "hard",
   "evidence": "in bed last night",
   "why": "You had them on in bed last night, so they could still be there.",
   "how_to_look": "Shake out the duvet and covers, then check along the mattress and underneath it."
  },
  {
   "n": 2,
   "score": 2,
   "spot_it": "easy",
   "evidence": "where I usually put them",
   "why": "This is where you usually put them, so they may be there.",
   "how_to_look": "Look across the top of the bedside table, checking around anything placed on it."
  },
  {
   "n": 3,
   "score": 0,
   "spot_it": "easy",
   "evidence": "",
   "why": "Nothing you wrote points to this spot.",
   "how_to_look": "Scan along the bathroom shelf, checking each item sitting on it."
  },
  {
   "n": 4,
   "score": 1,
   "spot_it": "easy",
   "evidence": "where I ate breakfast",
   "why": "You ate breakfast at the kitchen table, so they could be nearby.",
   "how_to_look": "Check all over the kitchen table and look underneath anything placed on it."
  },
  {
   "n": 5,
   "score": 0,
   "spot_it": "fair",
   "evidence": "I packed it yesterday",
   "why": "You packed the work bag yesterday, so they could be inside.",
   "how_to_look": "Open the work bag and check inside, including any pockets or compartments."
  }
 ],
 "elsewhere": {
  "uncovered": [
   "had a shower",
   "got dressed in the bedroom"
  ],
  "why": "The shower and getting dressed are not covered by the spots above, so something could still be in those steps.",
  "retrace": "reading in bed last night then made breakfast then had a shower then got dressed in the bedroom"
 },
 "closing": "Take your time with the search, and know there is no rush to it."
}

{
 "task": "search-plan",
 "item": "black folding umbrella",
 "last_seen": "I had it at the café when it started raining",
 "since": "I walked to the bus stop, took the bus home and popped into the corner shop on my street",
 "spots": "1. the café\n2. the bus\n3. the corner shop\n4. umbrella stand in the hall\n5. my backpack - note: it fits in the side pocket",
 "spot_count": "5",
 "facts": "spots listed: 5 (numbered 1 to 5); reply with exactly 5 spot entries in that order\nthe page adds its own share for somewhere not listed, from the uncovered steps\nchances are judged before any searching: ignore any searches the story says were already done - the page applies the person's search marks itself"
}

{
 "task": "search-plan",
 "summary": "After the café, nothing you describe says what happened to the umbrella until you reached home.",
 "spots": [
  {
   "n": 1,
   "score": 3,
   "spot_it": "fair",
   "evidence": "I had it at the café",
   "why": "You had the umbrella at the café, so it could still be there.",
   "how_to_look": "Ask the café staff if they have seen or put aside the umbrella."
  },
  {
   "n": 2,
   "score": 1,
   "spot_it": "fair",
   "evidence": "took the bus home",
   "why": "You took the bus home, so the umbrella could have been left on the bus.",
   "how_to_look": "Ask the bus staff whether the umbrella was handed in or left behind."
  },
  {
   "n": 3,
   "score": 1,
   "spot_it": "fair",
   "evidence": "popped into the corner shop",
   "why": "You popped into the corner shop, so the umbrella could have been set down there.",
   "how_to_look": "Ask the corner shop staff if the umbrella was left or handed in."
  },
  {
   "n": 4,
   "score": 0,
   "spot_it": "easy",
   "evidence": "",
   "why": "Nothing in your words points to the umbrella stand in the hall.",
   "how_to_look": "Look at the umbrella stand in the hall; a quick glance will show whether the umbrella is there."
  },
  {
   "n": 5,
   "score": 0,
   "spot_it": "fair",
   "evidence": "it fits in the side pocket",
   "why": "The backpack's side pocket fits the umbrella, so it could be tucked inside.",
   "how_to_look": "Open the backpack and check inside, including the side pocket, by feel and sight."
  }
 ],
 "elsewhere": {
  "uncovered": [
   "the bus stop",
   "on my street"
  ],
  "why": "The bus stop and your street are not among the listed spots, so the umbrella could also be along either stretch.",
  "retrace": "You had it at the café when it started raining, then walked to the bus stop, then took the bus home, then popped into the corner shop on your street."
 },
 "closing": "Take your time checking each spot calmly, without rushing or assuming where the umbrella must be."
}

const K = SearchKit;
const form = K.form({ item: "house keys on a red fob", last_seen: "I unlocked the front door with them when I got back from the shop",
  since: "I hung my coat on the hook", spots: [{ name: "front door" }, { name: "coat pocket", mark: "quick" }] });
const built = K.buildInput(form);
const wire = K.toWire(built.input);     // POST this to /estimate and /run (search marks are not sent)
// then: const reply = K.normalize(K.parseReply(job.output.output));
// K.plan(form, reply)                  // chances before and now, find chances, order, verdict
// K.check(reply, built).notes          // the page's re-check of the reply
// K.md(built, reply, "my keys")        // the plan as Markdown

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

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

# input.json: the run input object - {"task": "search-plan", "item": "house keys on a red fob", "last_seen": "I unlocked the front door with them when I got back from the shop", "since": "...", "spots": "1. front door - note: ...\n2. key bowl by the door ...", "spot_count": "5", "facts": "spots listed: 5 ..."}
# - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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