Get verdict (Step 7) | ForbocAI SDK

curl -X POST https://api.forboc.ai/npcs/npcId/verdict \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "generatedOutput": "The NPC decides to investigate the strange noise coming from the east corridor.",
  "observation": "Player reports hearing a mysterious sound near the east corridor at 22:15.",
  "npcState": {}
}'

{
  "valid": true,
  "signature": "a3f5c9d8e7b1f2a4c6d8e9f0b1a2c3d4e5f67890abcdef1234567890abcdef12",
  "memoryStore": [
    {
      "text": "NPC noted the strange noise at east corridor and plans to investigate.",
      "type": "observation",
      "importance": 0.85
    }
  ],
  "stateDelta": {},
  "action": {
    "type": "investigate",
    "reason": "Unidentified noise detected, potential threat assessment required.",
    "target": "east corridor"
  },
  "dialogue": "I heard something unusual near the east corridor. I'll check it out."
}

SDK sends SLM-generated output. API validates it against rules, signs it, and returns memory storage instructions + state delta for the SDK to execute locally.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

npcIdstringRequired

Request

This endpoint expects an object.

generatedOutputstringRequired

Raw output from the local SLM

observationstringRequired

Original observation (echoed)

npcStatemap from strings to anyRequired

rulesetIdstring or nullOptional

Response

Validation verdict with storage/state instructions

validboolean

Whether the generated output passed validation

signaturestring or null

Cryptographic signature (HMAC) if valid

memoryStorelist of objects

Instructions for what the SDK should store in its local vector DB

stateDeltamap from strings to any

State changes for the SDK to apply locally

actionobject or null

Validated action to return to the game

dialoguestring

Validated dialogue text returned to the caller