Drive Clear to Share from your own code

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

{
 "task": "screen",
 "ok_to_show": "WrenNest",
 "messages": "[{\"id\":\"M1\",\"who\":\"You\",\"text\":\"My parents' wifi keeps dropping and I'm setting it up for them this weekend. The router admin password is Harbor-Lantern-58 and the network is called WrenNest.\",\"hits\":[\"password\"]},{\"id\":\"M2\",\"who\":\"Assistant\",\"text\":\"Thanks. First, log in to the router and check which channel it uses. Crowded channels are the usual cause of drops.\",\"hits\":[]},{\"id\":\"M3\",\"who\":\"You\",\"text\":\"Ok. Their house is 27 Wren Close and the router sits in the back bedroom. If the provider calls, their landlin ... (720 characters)"
}

{
 "task": "screen",
 "verdict": "keep-private",
 "title": "Setting up parents' wifi password",
 "summary": "This chat has three findings, one of them a password, so it's best kept private. The street address and phone number would let a stranger find or contact the parents directly, and that password is worth changing anyway, since this chat already holds it.",
 "findings": [
  {
   "msg": "M1",
   "quote": "Harbor-Lantern-58",
   "kind": "secret",
   "risk": "high",
   "why": "Anyone who read this could log into the router and change its settings or network.",
   "swap": "[router password]"
  },
  {
   "msg": "M3",
   "quote": "27 Wren Close",
   "kind": "contact",
   "risk": "high",
   "why": "A stranger would know exactly which house to go to.",
   "swap": "[street address]"
  },
  {
   "msg": "M3",
   "quote": "01632 960 418",
   "kind": "contact",
   "risk": "high",
   "why": "A stranger could call the house directly.",
   "swap": "[phone number]"
  }
 ],
 "tips": []
}

{
 "task": "screen",
 "ok_to_show": "",
 "messages": "[{\"id\":\"M1\",\"who\":\"You\",\"text\":\"I need help writing a message to my coworker Dana Quellwick. Dana keeps taking credit for my reports in the Monday meeting.\",\"hits\":[]},{\"id\":\"M2\",\"who\":\"Assistant\",\"text\":\"That sounds frustrating. Do you want the message to be direct or gentle?\",\"hits\":[]},{\"id\":\"M3\",\"who\":\"You\",\"text\":\"Direct but kind. We both work at Brindlequay Freight and the team is about to be split in a reorg that hasn't been announced yet. My work email is sam.k@brindlequayfreight.example if that matters.\",\"hits\":[\"ema ... (710 characters)"
}

{
 "task": "screen",
 "verdict": "redact-first",
 "title": "Writing a direct but kind message",
 "summary": "This chat names the coworker in two forms, identifies the employer, spells out an unannounced company plan, includes a work email address, and describes a workplace dispute - six findings in all, none of them a secret. The placeholders make the chat safe to share.",
 "findings": [
  {
   "msg": "M1",
   "quote": "Dana Quellwick",
   "kind": "people",
   "risk": "medium",
   "why": "A stranger could identify the coworker by name and link this dispute to a real person.",
   "swap": "[the coworker]"
  },
  {
   "msg": "M1",
   "quote": "Dana",
   "kind": "people",
   "risk": "low",
   "why": "The first name alone still points back to the same coworker if it isn't masked too.",
   "swap": "[the coworker]"
  },
  {
   "msg": "M1",
   "quote": "taking credit for my reports in the Monday meeting",
   "kind": "work",
   "risk": "medium",
   "why": "This spells out a specific internal dispute that could embarrass the coworker if it became public.",
   "swap": "[the workplace dispute]"
  },
  "... (6 in all)"
 ],
 "tips": []
}

{
 "task": "screen",
 "ok_to_show": "",
 "messages": "[{\"id\":\"M1\",\"who\":\"You\",\"text\":\"My bedroom door squeaks every time I open it. It's an old flat in Leeds, so every door squeaks. What can I use?\",\"hits\":[]},{\"id\":\"M2\",\"who\":\"Assistant\",\"text\":\"Lift the hinge pin out, wipe it, and coat it with a little petroleum jelly or a drop of light machine oil. Tap it back in and swing the door a few times.\",\"hits\":[]},{\"id\":\"M3\",\"who\":\"You\",\"text\":\"Does cooking oil work?\",\"hits\":[]},{\"id\":\"M4\",\"who\":\"Assistant\",\"text\":\"It can for a while, but it turns sticky and gathers dust.  ... (577 characters)"
}

{
 "task": "screen",
 "verdict": "clear",
 "title": "Bedroom door squeaks and oil",
 "summary": "This is a short how-to chat about quieting a squeaky door, with a reply comparing household oils. A city name shows roughly where the flat is, but on its own it's too general to single anyone out. Nothing in the chat points to a person, so it looks fine to share as is.",
 "findings": [
  {
   "msg": "M1",
   "quote": "Leeds",
   "kind": "whereabouts",
   "risk": "low",
   "why": "A stranger could learn roughly which city the sharer's home is in.",
   "swap": "[the city]"
  }
 ],
 "tips": []
}

{
 "task": "screen",
 "ok_to_show": "",
 "messages": "[{\"id\":\"M1\",\"who\":\"You\",\"text\":\"can you check this before I post it?\",\"hits\":[]}]"
}

{
 "task": "screen",
 "verdict": "needs-chat",
 "title": "Check this before you post",
 "summary": "There's not enough here yet to screen for anything risky. Paste the full conversation so it can be checked before you post it.",
 "findings": [],
 "tips": [
  "Paste the whole conversation, not just one line.",
  "Keep each message's speaker label when you paste it.",
  "Include the part you actually plan to share."
 ]
}

const K = ShareKit;
const form = K.form({ ok: "my first name",
  chat: "You: Can you help me reply to my landlord?\nAssistant: Sure - what is it about?\nYou: The boiler. My number is 01632 960 000." });
console.log(K.flags(form), K.allHits(form), K.lean(form));  // the flags, every pattern found, the page's lean
console.log(K.redacted(form, null));                          // the free quick mask - patterns only
const wire = K.toWire(K.buildInput("screen", form).input);    // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// const { notes } = K.check(reply, form);                     // the page's re-check of the reply
// K.redacted(form, reply)                                     // the copy to share

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

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

# input.json: the run input object - {"task": "screen", "ok_to_show": "", "messages": "[{\"id\":\"M1\",\"who\":\"You\",\"text\":\"I need help writing a message to my coworker Dana Quellwick. Dana keeps taking credit for my reports in the Monday meeting.\",\"hits\":[]}, ...]"}
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

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