API endpoint /decide

app.py

@@ -155,6 +155,40 @@ def decide(state, n, *fields):
     return run(state, qs)
 
 
+def decide_api(state: str, questions: list):
+    """Score typed decisions about one state with Blink v0.3.
+
+    Args:
+        state: the situation — plain text, or a JSON object/array as a string.
+        questions: up to 4 items {"type": "choice"|"noul"|"score", "question": str, "options": [str]}.
+            choice: "key" or "key: description" per option; score: levels from lowest to highest;
+            noul (yes/no): options optional ("false: ...", "true: ...").
+
+    Returns:
+        {"answers": [{type, question, keys, probabilities, best, logprobs, ms}], "temperature": 1.3, "total_ms": int}
+    """
+    if not isinstance(questions, list) or not 1 <= len(questions) <= MAXQ:
+        raise gr.Error(f"questions must be a list of 1 to {MAXQ} items")
+    qs = []
+    for q in questions:
+        kind = q.get("type")
+        if kind not in ("choice", "noul", "score"):
+            raise gr.Error("type must be choice, noul or score")
+        try:
+            build(kind, list(q.get("options") or []))
+        except ValueError as e:
+            raise gr.Error(f"{q.get('question', '')[:60]}: {e}")
+        qs.append((kind, str(q.get("question", "")).strip(), list(q.get("options") or [])))
+    res = run(state, qs)
+    for a in res["answers"]:
+        p = soft(a["logprobs"], T_CALIBRATED)
+        a["probabilities"] = dict(zip(a["keys"], [round(v, 4) for v in p]))
+        a["best"] = a["keys"][max(range(len(p)), key=p.__getitem__)]
+        a.pop("prompt", None)
+    res["temperature"] = T_CALIBRATED
+    return res
+
+
 def load_example(i):
     _, state, qs = EX[i]
     ups = [state, len(qs), None]
@@ -201,6 +235,9 @@ with gr.Blocks(title="Blink v0.3 — one forward pass, one calibrated decision")
             temp = gr.Slider(0.5, 3.0, value=T_CALIBRATED, step=0.05, label="Temperature · 1.3 is calibrated")
             gr.HTML(NOTE)
     gr.HTML(HOW)
+    with gr.Row(visible=False):     # API-only endpoint: POST /decide (state, questions) -> JSON
+        api_state, api_qs, api_out = gr.Textbox(), gr.JSON(), gr.JSON()
+        gr.Button().click(decide_api, [api_state, api_qs], api_out, api_name="decide")
 
     go.click(decide, [state, nq, *fields], res).then(lambda r, t: readout(r, t, True), [res, temp], out)
     temp.change(lambda r, t: readout(r, t, False), [res, temp], out, show_progress="hidden")