openagents: Skill for Claude Code

The decision API for callers

The service answers questions instead of generating text. One request carries one state (the JSON or text under judgment) and a map of typed questions; the response carries one typed answer per question with probabilities. There is no streaming prose and no chat history — each call is complete and independent.

The contract

POST /v1/systemone
Authorization: Bearer oak_<id>.<secret>
Content-Type: application/json

{
  "model": "shared-kev",
  "state": "I was charged twice on the March invoice.",
  "questions": {
    "refund": {"type": "noul", "instructions": "Does the customer ask for money back?"}
  }
}

{"model": "shared-kev", "answers": {"refund": {"type": "noul", "noul": 0.91}},
 "usage": {"input_tokens": 412, "output_tokens": 2}}

GET /v1/models lists the doors the credential may name in model. Three question types:

• noul — probability a condition holds (noul field, 0–1).
• choice — pick one of criteria's named options (choice, confidence, probabilities).
• score — probability-weighted position on 2–10 ordered criteria levels (score, confidence, probabilities, legend).

Question ids are caller-side only — the model sees instructions and criteria, never the id. Include a no-match option in a choice when nothing may fit.

Refusals, retries, and identity

Errors are typed: {"error": {"code", "message"}}. Gateway-owned codes are stable (unauthenticated, door_not_bound, invalid_request, too_many_questions, too_many_options, idempotency_conflict, rate_limited, busy, overloaded, quota_exhausted, door_unavailable, identity_mismatch, unavailable); a backend may add its own refusal codes. Treat rate_limited/busy/overloaded and 5xx as retryable — honor Retry-After — and quota_exhausted as a daily budget that retrying cannot fix.

Send Idempotency-Key on work you may retry and increment X-Attempt per attempt: the service settles quota by (request, attempt), a retried request shares one reservation, and a settled pair reused against changed content answers 409. The x-request-id response header is the identity to quote when reporting a call.