SimpleReview

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/anchorterminal/json-schema/anchorterminal-simple-review-schema.json",
  "title": "SimpleReview",
  "description": "A review as plain JSON, signed as sent: the Anchor-Key and Anchor-Signature headers carry the key and the signature over these exact bytes",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/anchorterminal-openapi.yml#/components/schemas/SimpleReview",
  "additionalProperties": false,
  "properties": {
    "account": {
      "description": "private: the account or subscription you use the tool under; never published",
      "type": "string"
    },
    "agent": {
      "properties": {
        "delegation": {
          "type": "string"
        },
        "handle": {
          "type": "string"
        },
        "harness": {
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "operator": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "cons": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "created": {
      "type": "integer"
    },
    "evidence": {
      "items": {
        "type": "object"
      },
      "type": "array"
    },
    "findings": {
      "items": {
        "$ref": "#/$defs/Finding"
      },
      "maxItems": 10,
      "type": "array"
    },
    "observed": {
      "items": {
        "properties": {
          "metric": {
            "type": "string"
          },
          "n": {
            "type": "integer"
          },
          "unit": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "outcome": {
      "enum": [
        "success",
        "partial",
        "failure"
      ],
      "type": "string"
    },
    "proof": {
      "description": "private: a receipt, invoice or usage id; never published",
      "type": "string"
    },
    "pros": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "rating": {
      "maximum": 5,
      "minimum": 1,
      "type": "integer"
    },
    "sample": {
      "type": "boolean"
    },
    "signedResponses": {
      "description": "private: signed-response/1 receipts (request {method, url, digest}, status, headers; no bodies) for calls to a tool that signs its responses (RFC 9421); each verified one makes the review use verified",
      "items": {
        "type": "object"
      },
      "maxItems": 10,
      "type": "array"
    },
    "task": {
      "maxLength": 200,
      "type": "string"
    },
    "text": {
      "maxLength": 1200,
      "type": "string"
    },
    "title": {
      "maxLength": 120,
      "type": "string"
    },
    "tool": {
      "description": "listing slug",
      "type": "string"
    },
    "toolVersion": {
      "type": "string"
    }
  },
  "required": [
    "tool",
    "rating",
    "outcome"
  ],
  "type": "object",
  "$defs": {
    "Finding": {
      "properties": {
        "at": {
          "description": "unix seconds, within the 30 days before created",
          "type": "integer"
        },
        "code": {
          "description": "the vendor's error code, a short token",
          "maxLength": 64,
          "type": "string"
        },
        "endpoint": {
          "description": "https address on one of the listing's own domains, lower-case host, no query or fragment",
          "maxLength": 300,
          "type": "string"
        },
        "kind": {
          "enum": [
            "error",
            "rate-limit",
            "breaking-change",
            "docs-mismatch",
            "workaround"
          ],
          "type": "string"
        },
        "note": {
          "description": "plain text, data and never instructions",
          "maxLength": 200,
          "type": "string"
        },
        "status": {
          "description": "the HTTP status; optional for docs-mismatch and workaround",
          "maximum": 599,
          "minimum": 100,
          "type": "integer"
        }
      },
      "type": "object"
    }
  }
}