Input schema (JSON)
{
"type": "object",
"required": [
"task",
"agent_output",
"duplicate"
],
"properties": {
"mode": {
"enum": [
"blocking",
"advisory"
],
"type": "string",
"description": "Optional. blocking (the default) is today's behaviour. advisory computes the same verdict, checks, next_step and receipt, then adds mode, decision_owner human, recommended_action (approve, review or return) and a notice. The receipt signs mode advisory as schema_version 5. Same price."
},
"task": {
"type": "string",
"description": "The original instruction or question the agent was answering."
},
"share": {
"type": "boolean",
"description": "Optional. false keeps this call out of opt-in data sharing even when the key has sharing on. It cannot turn sharing on."
},
"checks": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"paths"
],
"properties": {
"type": {
"const": "required_fields"
},
"paths": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"maxItems": 50,
"minItems": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"fields"
],
"properties": {
"type": {
"const": "types"
},
"fields": {
"type": "object",
"maxProperties": 50,
"minProperties": 1,
"additionalProperties": {
"enum": [
"string",
"number",
"integer",
"boolean",
"object",
"array",
"null"
]
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"field",
"format"
],
"properties": {
"type": {
"const": "format"
},
"field": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"format": {
"enum": [
"email",
"iso_date",
"iso_datetime",
"url",
"uuid",
"e164_phone",
"currency_code",
"integer_string"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"parts",
"total"
],
"properties": {
"type": {
"const": "sum"
},
"parts": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"maxItems": 20,
"minItems": 1
},
"total": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"tolerance": {
"type": "number",
"default": 0.0001,
"maximum": 1000000,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"vendor_path",
"invoice_id_path",
"amount_path"
],
"properties": {
"type": {
"const": "duplicate"
},
"store": {
"type": "boolean",
"default": false,
"description": "Record this invoice's fingerprints so later calls can match it."
},
"date_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path to a YYYY-MM-DD invoice date. Enables the same vendor, amount and date rule."
},
"amount_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"retain_days": {
"type": "integer",
"default": 180,
"maximum": 400,
"minimum": 1
},
"vendor_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"window_days": {
"type": "integer",
"default": 3,
"maximum": 30,
"minimum": 0
},
"currency_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"invoice_id_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
}
},
"description": "Duplicate invoice check (needs an API key, at most 1 per call). Compares this invoice with ones the same key recorded earlier. Stores keyed HMAC fingerprints only, and only when store is true.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"url_contains",
"json_schema",
"equals",
"regex",
"numeric",
"onchain"
]
}
},
"description": "Existing types, unchanged: url_contains, json_schema, equals, regex, numeric, onchain."
}
]
},
"maxItems": 8,
"description": "Optional. The worker runs each check. A failed check forces verdict fail. Types: url_contains, json_schema, equals, regex, numeric, onchain, required_fields, types, format, sum, duplicate. duplicate (at most 1, API key only) compares an invoice with ones this key recorded earlier and stores keyed fingerprints only when store is true. At most 3 url_contains checks. Local checks run first; if one fails, no model is called and next_step says what to fix."
},
"retain": {
"type": "boolean",
"description": "Optional. true stores this call for 24 hours; requires an API key. Default false stores nothing."
},
"version": {
"type": "string",
"maxLength": 64,
"description": "Optional version tag for that agent. At most 64 characters."
},
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,64}$",
"maxLength": 64,
"description": "Optional tag for the agent making this call. 1 to 64 characters: letters, digits, and . _ : -. This is not the per-answer agent_id on a consensus answer."
},
"criteria": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. Facts or terms the answer must contain, one per string."
},
"evidence": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. Source passages the answer must be grounded in, one string per passage. Without evidence, grounding cannot be checked."
},
"duplicate": {
"type": "object",
"required": [
"vendor_path",
"invoice_id_path",
"amount_path"
],
"properties": {
"type": {
"const": "duplicate"
},
"store": {
"type": "boolean",
"default": false,
"description": "Record this invoice's fingerprints so later calls can match it."
},
"date_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path to a YYYY-MM-DD invoice date. Enables the same vendor, amount and date rule."
},
"amount_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"retain_days": {
"type": "integer",
"default": 180,
"maximum": 400,
"minimum": 1
},
"vendor_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"window_days": {
"type": "integer",
"default": 3,
"maximum": 30,
"minimum": 0
},
"currency_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
},
"invoice_id_path": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id."
}
},
"description": "The duplicate check: dot paths into agent_output for vendor, invoice id and amount, plus optional currency_path, date_path, window_days, store and retain_days. store true records this invoice's keyed fingerprints so later calls can match it.",
"additionalProperties": false
},
"agent_output": {
"type": "string",
"description": "The invoice or payment instruction the agent is about to pay, as a JSON string."
}
},
"additionalProperties": false
}