Upload folder using huggingface_hub

space_ui/__init__.py

@@ -0,0 +1 @@
+# space_ui: theme, CSS, texts and demo schemas for the OEV Space demo.

space_ui/css.py

@@ -0,0 +1,176 @@
+# Gradio theme + CSS for the OEV Space demo. One place for the look.
+import gradio as gr
+
+theme = gr.themes.Soft(
+    primary_hue="orange",
+    neutral_hue="slate",
+    font=[gr.themes.GoogleFont("IBM Plex Sans"), "ui-sans-serif", "system-ui", "sans-serif"],
+    font_mono=[gr.themes.GoogleFont("IBM Plex Mono"), "ui-monospace", "monospace"],
+).set(
+    body_background_fill="#171412",
+    body_background_fill_dark="#171412",
+    body_text_color="#f5eee8",
+    body_text_color_dark="#f5eee8",
+    body_text_color_subdued="#b9aa9f",
+    body_text_color_subdued_dark="#b9aa9f",
+    block_background_fill="#211d1a",
+    block_background_fill_dark="#211d1a",
+    block_border_color="#3a2f28",
+    block_border_color_dark="#3a2f28",
+    border_color_primary="#3a2f28",
+    border_color_primary_dark="#3a2f28",
+    color_accent="#e8b48c",
+    color_accent_soft="#5a4032",
+    color_accent_soft_dark="#5a4032",
+    border_color_accent="#e8b48c",
+    border_color_accent_dark="#e8b48c",
+    input_background_fill="#1b1816",
+    input_background_fill_dark="#1b1816",
+    input_border_color="#4a3b32",
+    input_border_color_dark="#4a3b32",
+    input_border_color_focus="#e8b48c",
+    input_border_color_focus_dark="#e8b48c",
+    button_primary_background_fill="#e8b48c",
+    button_primary_background_fill_dark="#e8b48c",
+    button_primary_background_fill_hover="#dca47a",
+    button_primary_background_fill_hover_dark="#dca47a",
+    button_primary_border_color="#e8b48c",
+    button_primary_border_color_dark="#e8b48c",
+    button_primary_border_color_hover="#dca47a",
+    button_primary_border_color_hover_dark="#dca47a",
+    button_primary_text_color="#2b1d16",
+    button_primary_text_color_dark="#2b1d16",
+    button_primary_text_color_hover="#2b1d16",
+    button_primary_text_color_hover_dark="#2b1d16",
+    button_secondary_background_fill="#2a2420",
+    button_secondary_background_fill_dark="#2a2420",
+    button_secondary_background_fill_hover="#352c26",
+    button_secondary_background_fill_hover_dark="#352c26",
+    button_secondary_border_color="#4a3b32",
+    button_secondary_border_color_dark="#4a3b32",
+    button_secondary_border_color_hover="#5a4639",
+    button_secondary_border_color_hover_dark="#5a4639",
+    button_secondary_text_color="#f5eee8",
+    button_secondary_text_color_dark="#f5eee8",
+    button_secondary_text_color_hover="#ffffff",
+    button_secondary_text_color_hover_dark="#ffffff",
+    block_border_width="1px",
+    block_radius="0px",
+    button_large_radius="0px",
+    button_small_radius="0px",
+    input_radius="0px",
+)
+
+CSS = """
+/* --- page frame: centered column --- */
+.gradio-container { width: 1020px !important; max-width: calc(100vw - 32px) !important; min-width: 0 !important; box-sizing: border-box !important; margin: 0 auto; }
+footer { visibility: hidden; }
+:root, .gradio-container { --primary-pastel: #e8b48c; --color-accent: var(--primary-pastel); --border-color-accent: var(--primary-pastel); }
+.gradio-container > main,
+.gradio-container .main,
+.tab-container,
+.tab-container > div,
+.tab-container .tab-panel,
+.tab-container .row { width: 100% !important; min-width: 0 !important; box-sizing: border-box !important; }
+.tab-container .column { min-width: 0 !important; box-sizing: border-box !important; }
+
+.gradio-container { font-size: 14px; line-height: 1.5; }
+.gradio-container p, .gradio-container textarea, .gradio-container input { font-size: 14px; line-height: 1.5; }
+.gradio-container h1 { font-size: 24px; line-height: 1.25; font-weight: 600; }
+.gradio-container h2 { font-size: 18px; line-height: 1.25; font-weight: 600; }
+.gradio-container h3 { font-size: 16px; line-height: 1.25; font-weight: 600; }
+.gradio-container label, .gradio-container .form-label, .gradio-container .block-label { font-size: 12px; line-height: 1.4; font-weight: 500; }
+.gradio-container button, .tab-nav button { font-size: 13px; line-height: 1.25; }
+
+/* --- everything square: override any gradio rounding --- */
+.gradio-container * { border-radius: 0 !important; }
+
+/* --- header --- */
+#header { padding: 12px 0 16px; border-bottom: 1px solid var(--border-color-primary);
+          margin-bottom: 16px; }
+#header h1 { margin: 0 0 8px; letter-spacing: -0.01em; }
+#header .prose p { color: var(--body-text-color-subdued); margin: 0 0 4px; }
+#header .metrics { font-family: var(--font-mono); font-size: 12px;
+                   color: var(--body-text-color-subdued);
+                   letter-spacing: 0.02em; }
+#header .metrics b { color: var(--body-text-color); font-weight: 600; }
+
+/* --- preset buttons: equal width, one row --- */
+#presets { gap: 8px; margin-bottom: 16px; }
+#presets button { flex: 1 1 0; min-width: 0; width: auto; height: 32px !important;
+                  min-height: 32px !important; padding: 0 12px !important; }
+
+/* --- accordion header matches the preset button height --- */
+#qs-help { margin: 12px 0; }
+#qs-help button { min-height: 32px !important; padding: 4px 12px !important; }
+
+/* --- decide: full width, own row --- */
+#decide-btn { width: 100%; min-height: 40px; margin-top: 16px; }
+.tab-container .row { gap: 16px; }
+
+/* --- code editors and viewers render mono --- */
+.cm-editor, .cm-content, .cm-line, textarea.code,
+#state-box textarea, #qs-box textarea {
+  font-family: var(--font-mono) !important;
+  font-size: 12px !important;
+}
+
+/* --- probability bars rendered from the payload markdown --- */
+.bars .qname { display: block; font-size: 12px; text-transform: uppercase;
+               letter-spacing: 0.1em; color: var(--body-text-color-subdued);
+               margin: 16px 0 8px; }
+.bars .row { display: flex; align-items: center; gap: 8px; margin: 4px 0; }
+.bars .row .name { flex: 0 0 38%; overflow: hidden; text-overflow: ellipsis;
+                   white-space: nowrap; font-size: 12px; }
+.bars .row .track { flex: 1 1 auto; height: 8px;
+                    background: var(--block-background-fill);
+                    border: 1px solid var(--border-color-primary); position: relative; }
+.bars .row .fill { position: absolute; inset: 0 auto 0 0; height: 100%;
+                   background: var(--color-accent); opacity: 0.75; }
+.bars .row.win .fill { background: var(--color-accent); opacity: 1; }
+.bars .row .val { flex: 0 0 52px; text-align: right;
+                  font-family: var(--font-mono); font-size: 12px;
+                  color: var(--body-text-color-subdued); }
+.bars .row.win .val { color: var(--body-text-color); font-weight: 600; }
+
+/* --- status line --- */
+#statusline { font-family: var(--font-mono); font-size: 12px;
+              color: var(--body-text-color-subdued); text-align: right;
+              min-height: 1.4em; margin-top: 8px; }
+
+/* --- error: red left rule --- */
+#errorbox { margin: 12px 0; padding: 12px;
+            border-left: 3px solid var(--color-danger) !important; }
+
+/* --- focus rings --- */
+#state-box textarea:focus, #qs-box textarea:focus, #qs-box input:focus,
+.cm-editor.cm-focused, .cm-content:focus {
+  outline: 2px solid var(--border-color-accent) !important;
+  outline-offset: -1px;
+}
+
+/* --- tab nav --- */
+.tab-nav { display: flex; width: 100%; gap: 8px; margin-bottom: 16px; }
+.tab-nav button { flex: 1 1 0; min-width: 0; min-height: 32px; padding: 6px 12px; font-size: 13px; letter-spacing: 0.04em; }
+.tab-nav button:hover,
+.tab-nav button:focus-visible,
+.tab-nav button[aria-selected="true"] {
+  color: var(--color-accent) !important;
+  -webkit-text-fill-color: var(--color-accent) !important;
+  background: var(--color-accent-soft) !important;
+  border-color: var(--color-accent) !important;
+  box-shadow: inset 0 -2px 0 var(--color-accent) !important;
+}
+.tab-nav button:hover *,
+.tab-nav button:focus-visible *,
+.tab-nav button[aria-selected="true"] * {
+  color: var(--color-accent) !important;
+  -webkit-text-fill-color: var(--color-accent) !important;
+}
+
+/* --- responsive: presets wrap on narrow screens --- */
+@media (max-width: 640px) {
+  #presets { flex-wrap: wrap; }
+  #presets button { flex: 1 1 45%; width: auto; }
+}
+"""

space_ui/schemas.py

@@ -0,0 +1,116 @@
+# Demo states and question schemas, verbatim from the typed-decisions
+# training data. Editing these is safe: they are plain JSON payloads.
+import json
+
+AGENT_STATE = ('{"agent": {"autonomy": "checkpointed", "model": "internal-agent-v4"}, '
+               '"constraints": ["Do not touch customer data outside the named accounts"], '
+               '"task": "Delete personal data for the accounts in the erasure queue.", '
+               '"trace_summary": {"constraint_violations": 0, "duration_s": 128.5, '
+               '"irreversible_actions": 0, "steps": 7, "tool_errors": 1}}')
+
+AGENT_QS = {
+    "action": {"type": "choice", "options": ["continue", "human_review", "observe", "stop"],
+               "instructions": "action"},
+    "needs_review": {"type": "noul"},
+    "outcome": {"type": "choice", "options": ["failure", "harmful", "partial", "success"],
+                "instructions": "outcome"},
+    "risk": {"type": "score",
+             "levels": ["Benign: read-only or clearly safe actions.", "Low: routine writes within scope.",
+                        "Moderate: irreversible or out-of-scope actions.",
+                        "High: destructive, security-relevant, or policy-violating actions."]},
+}
+
+
+def customer_state(tier, tickets, msg):
+    return json.dumps({
+        "account": {"lifetime_value_usd": 4642, "prior_tickets_90d": int(tickets),
+                    "seats": 3, "tenure_months": 60, "tier": tier},
+        "thread": [{"role": "customer", "text": msg}],
+    })
+
+
+CUSTOMER_QS = {
+    "action": {"type": "choice",
+               "options": ["answer_directly", "close_no_action", "escalate_to_human",
+                           "execute_refund", "request_information"],
+               "instructions": "action"},
+    "category": {"type": "choice", "options": ["account", "billing", "delivery", "refund", "technical"],
+                 "instructions": "category"},
+    "churn_risk": {"type": "score",
+                   "levels": ["No sign of dissatisfaction.", "Mild frustration, but the relationship is intact.",
+                              "Clearly unhappy; repeat problems or explicit complaints.",
+                              "Imminent: threatening to cancel, dispute or leave."]},
+    "needs_human": {"type": "noul"},
+}
+
+INVOICE_QS = {
+    "discrepancy_severity": {"type": "score",
+                             "levels": ["None: everything reconciles.",
+                                        "Trivial: rounding or a cosmetic difference.",
+                                        "Moderate: a real difference worth confirming.",
+                                        "Material: a large or unexplained difference."]},
+    "disposition": {"type": "choice", "options": ["approve", "hold", "manual_review", "reject"],
+                    "instructions": "disposition"},
+    "duplicate": {"type": "noul"},
+    "matches_order": {"type": "noul"},
+}
+
+
+def invoice_state(vendor, inv, po, recv, ordered, disputes):
+    return json.dumps({
+        "delivery": {"condition": "accepted with exceptions", "date": "2026-03-18",
+                     "received_qty": int(recv)},
+        "invoice": {"currency": "USD", "id": "INV-2026-7551",
+                    "lines": [{"qty": int(ordered), "sku": "SKU-940",
+                               "total_usd": float(inv),
+                               "unit_usd": round(float(inv) / max(int(ordered), 1), 2)}],
+                    "total_usd": float(inv), "vendor": vendor},
+        "payment": {"days_until_due": -3, "discount_expires_in_days": None,
+                    "early_payment_discount_pct": None},
+        "purchase_order": {"id": "PO-2026-4102",
+                           "lines": [{"qty": int(ordered), "sku": "SKU-940",
+                                      "total_usd": float(po),
+                                      "unit_usd": round(float(po) / max(int(ordered), 1), 2)}]},
+        "vendor_history": {"invoices_last_12m": 14, "disputes_last_12m": int(disputes)},
+    })
+
+
+SECURITY_QS = {
+    "credential_compromise": {"type": "noul"},
+    "disposition": {"type": "choice", "options": ["close_benign", "contain", "investigate", "monitor"],
+                    "instructions": "disposition"},
+    "severity": {"type": "score",
+                 "levels": ["Negligible: no access to anything sensitive.",
+                            "Low: limited access, easily reversed.",
+                            "Moderate: access to internal systems or non-public data.",
+                            "High: access to production, secrets or customer data.",
+                            "Critical: active compromise of crown-jewel systems."]},
+    "true_positive": {"type": "noul"},
+}
+
+
+def security_state(rule, desc, evid, crit, ptype):
+    return json.dumps({
+        "alert": {"description": desc, "evidence": evid, "rule": rule},
+        "context": {"asset_criticality": crit, "change_window_active": False},
+        "history": {"prior_incidents_90d": 0},
+        "principal": {"department": "engineering", "roles": ["service"], "type": ptype},
+    })
+
+
+PLAYGROUND_STATE = "Shoes arrived two weeks late and in the wrong size. Also I see two charges on my card. What are you going to do about this?"
+
+PLAYGROUND_QS = {
+    "department": {"type": "choice",
+                   "instructions": "Which team should handle this?",
+                   "options": ["billing", "shipping", "other"]},
+    "escalate": {"type": "noul", "instructions": "Does this need urgent human attention?"},
+    "frustration": {"type": "score", "levels": ["calm", "frustrated", "very angry"]},
+}
+
+# cross-field sanity rules: (if_field, if_value, then_field, expected)
+COHERENCE_RULES = [
+    ("action", "human_review", "needs_review", "yes"),
+    ("action", "stop", "needs_review", "yes"),
+    ("action", "continue", "needs_review", "no"),
+]

space_ui/texts.py

@@ -0,0 +1,62 @@
+# Markdown constants shown in the Space UI.
+TITLE_MD = """
+<div id="header">
+<h1>OEV</h1>
+<p><b>Typed questions in. Calibrated probabilities out. One forward pass. Nothing is generated.</b></p>
+<p class="metrics"><b>184M</b> params · calibrated distributions · <b>0</b> tokens generated</p>
+</div>
+"""
+
+QS_HELP = """**Question schema** - one JSON object per question name:
+
+```json
+{
+  "question_name": {
+    "type": "choice",          // "choice" | "noul" (yes/no) | "score" (ordinal)
+    "options": ["a", "b"],     // choice: the labels; score: level descriptions
+    "levels": ["low", "high"], // score only: ordinal level descriptions
+    "instructions": "what to decide"
+  }
+}
+```
+"""
+
+API_DOCS = r"""## Use OEV from code
+
+The Space exposes one public API event, `decide`. Calls use two steps: submit
+inputs, then fetch the streamed result by event ID.
+
+```bash
+SPACE_URL="https://divyanshudhruv-oev-demo.hf.space"
+EVENT_ID=$(curl -sS -X POST "$SPACE_URL/call/decide" \
+  -H "Content-Type: application/json" \
+  -d '{"data": ["state text", "{\"action\": {\"type\": \"choice\", \"options\": [\"continue\", \"stop\"]}}", 1.0]}' |
+  python -c "import json,sys; print(json.load(sys.stdin)['event_id'])")
+curl -N "$SPACE_URL/call/decide/$EVENT_ID"
+```
+
+The response is an output list. Its first item is a JSON object with one
+entry per question. Choice and score questions include `answer`, `confidence`,
+and the full `probabilities` distribution. Yes/no questions include `p_yes`
+
+Or with the `gradio_client`:
+
+```python
+from gradio_client import Client
+client = Client("divyanshudhruv/oev-demo")
+result = client.predict(
+    state,          # str: plain text or JSON document
+    questions,      # str: JSON, {"name": {"type": "choice|noul|score", ...}}
+    1.0,            # float: temperature
+    api_name="/decide",
+)
+```
+
+Python (local install):
+
+```python
+from oev.infer import OEV
+agent = OEV("divyanshudhruv/oev-typed/student-r3-oev-tiny.pt")
+result = agent.decide(state, questions)
+```
+"""