MonkeyAI TypeSafe: structured decisions and scoring

export TYPESAFE_API_KEY="YOUR_API_KEY"

$env:TYPESAFE_API_KEY="YOUR_API_KEY"

curl --fail-with-body --connect-timeout 15 --max-time 120   "https://monkeytheme.com/v1/systemone"   -H "Authorization: Bearer $TYPESAFE_API_KEY"   -H "Content-Type: application/json"   --data-binary '{"model":"jev-latest","state":"Please replace my damaged parcel.","questions":{"replacement":{"type":"noul","instructions":"Is a replacement requested?"}}}'

import base64
import json
import os
import sys
import urllib.error
import urllib.request
import uuid
from pathlib import Path

# python typesafe_demo.py text|file|image

def evaluate(body):
    request = urllib.request.Request(
        "https://monkeytheme.com/v1/systemone",
        data=json.dumps(body, ensure_ascii=False).encode("utf-8"),
        headers={"Authorization": "Bearer " + os.environ["TYPESAFE_API_KEY"],
                 "Content-Type": "application/json"}, method="POST")
    try:
        with urllib.request.urlopen(request, timeout=120) as response:
            result = json.load(response)
    except urllib.error.HTTPError as error:
        # Do not log credentials or private request contents.
        raise RuntimeError(f"HTTP {error.code}; inspect a redacted error body locally") from error
    if not isinstance(result.get("answers"), dict):
        raise ValueError("Response has no answers object")
    return result

try:
    mode = sys.argv[1]
    body = {"model": "jev-latest", "state": {"note":
        "The delivery arrived damaged. Can someone arrange a replacement this week?"},
        "questions": {
            "replacement": {"type": "noul", "instructions": "Is a replacement requested?",
                "criteria": {"true": "A replacement is requested.",
                             "false": "No replacement is requested."}},
            "route": {"type": "choice", "instructions": "Select the responsible team.",
                "criteria": {"delivery": "Damaged or missing deliveries.",
                             "account": "Account access.", "other": "Other issues."}},
            "priority": {"type": "score", "instructions": "Assess the stated time pressure.",
                "criteria": ["No deadline.", "Within a week.", "Immediate action required."]}}}
    if mode == "file":
        body["state"] = Path("document.txt").read_text(encoding="utf-8")
        body["questions"] = {"renewal": {"type": "noul",
            "instructions": "Does the document require an explicit renewal decision?"}}
    elif mode == "image":
        # Unverified on MonkeyAI: confirm image capability before using this mode.
        ref = str(uuid.uuid4())
        body["state"] = {"photo": ref}
        body["assets"] = {ref: {"type": "image", "format": "png",
            "data_base64": base64.b64encode(Path("input.png").read_bytes()).decode("ascii")}}
        body["questions"] = {"label_visible": {"type": "noul",
            "instructions": "Is a shipping label visible in the image?"}}
    elif mode != "text":
        raise ValueError("Use text, file or image")
    result = evaluate(body)
    print(json.dumps(result, ensure_ascii=False, indent=2))
    if mode == "text":
        probability = result["answers"]["replacement"]["noul"]
        if isinstance(probability, bool) or not isinstance(probability, (int, float)) or not 0 <= probability <= 1:
            raise ValueError("Invalid noul probability")
        # 0.8 is an illustrative policy threshold, not a service guarantee.
        print("Review for replacement:", probability >= 0.8)
    print("usage:", result.get("usage"))
except (OSError, ValueError, KeyError, TypeError, RuntimeError) as error:
    print("TypeSafe request failed:", error, file=sys.stderr)
    sys.exit(1)

import fs from "node:fs/promises";
import {randomUUID} from "node:crypto";

// node typesafe_demo.mjs text|file|image
async function evaluate(body) {
  const key = process.env.TYPESAFE_API_KEY;
  if (!key) throw new Error("Set TYPESAFE_API_KEY");
  const response = await fetch("https://monkeytheme.com/v1/systemone", {
    method: "POST", headers: {Authorization: `Bearer ${key}`, "Content-Type": "application/json"},
    body: JSON.stringify(body), signal: AbortSignal.timeout(120000)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}; inspect a redacted error body locally`);
  const result = await response.json();
  if (!result.answers || typeof result.answers !== "object" || Array.isArray(result.answers))
    throw new Error("Response has no answers object");
  return result;
}
try {
  const mode = process.argv[2];
  const body = {model: "jev-latest", state: {note:
    "The delivery arrived damaged. Can someone arrange a replacement this week?"},
    questions: {
      replacement: {type: "noul", instructions: "Is a replacement requested?",
        criteria: {true: "A replacement is requested.", false: "No replacement is requested."}},
      route: {type: "choice", instructions: "Select the responsible team.",
        criteria: {delivery: "Damaged or missing deliveries.", account: "Account access.", other: "Other issues."}},
      priority: {type: "score", instructions: "Assess the stated time pressure.",
        criteria: ["No deadline.", "Within a week.", "Immediate action required."]}
    }};
  if (mode === "file") {
    body.state = await fs.readFile("document.txt", "utf8");
    body.questions = {renewal: {type: "noul",
      instructions: "Does the document require an explicit renewal decision?"}};
  } else if (mode === "image") {
    // Unverified on MonkeyAI: confirm image capability before using this mode.
    const ref = randomUUID();
    body.state = {photo: ref};
    body.assets = {[ref]: {type: "image", format: "png",
      data_base64: (await fs.readFile("input.png")).toString("base64")}};
    body.questions = {label_visible: {type: "noul",
      instructions: "Is a shipping label visible in the image?"}};
  } else if (mode !== "text") throw new Error("Use text, file or image");
  const result = await evaluate(body);
  console.log(JSON.stringify(result, null, 2));
  if (mode === "text") {
    const probability = result.answers.replacement.noul;
    if (typeof probability !== "number" || probability < 0 || probability > 1)
      throw new Error("Invalid noul probability");
    console.log("Review for replacement:", probability >= 0.8);
  }
  console.log("usage:", result.usage);
} catch (error) {
  console.error("TypeSafe request failed:", error.message);
  process.exitCode = 1;
}

{"target": {"type": "box", "instructions": "Locate the shipping label in the referenced image."}}