Input schema (JSON)
{
"type": "object",
"$defs": {
"rule": {
"type": "object",
"required": [
"rule_id",
"condition",
"outcome"
],
"properties": {
"outcome": {
"$ref": "#/$defs/outcome"
},
"rule_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_.:-]{1,119}$"
},
"priority": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": -1000
},
"condition": {
"$ref": "#/$defs/condition"
}
},
"additionalProperties": false
},
"outcome": {
"type": "object",
"required": [
"decision",
"verdict",
"action",
"reason_code"
],
"properties": {
"action": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"verdict": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9_]{1,79}$"
},
"decision": {
"enum": [
"yes",
"no",
"review"
],
"type": "string"
},
"reason_code": {
"type": "string",
"pattern": "^[A-Z][A-Z0-9_]{1,79}$"
}
},
"additionalProperties": false
},
"condition": {
"oneOf": [
{
"type": "object",
"required": [
"all"
],
"properties": {
"all": {
"type": "array",
"items": {
"$ref": "#/$defs/condition"
},
"maxItems": 32,
"minItems": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"any"
],
"properties": {
"any": {
"type": "array",
"items": {
"$ref": "#/$defs/condition"
},
"maxItems": 32,
"minItems": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"not"
],
"properties": {
"not": {
"$ref": "#/$defs/condition"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"field",
"operator"
],
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,159}$"
},
"value": true,
"operator": {
"enum": [
"exists",
"not_exists",
"eq",
"neq",
"gt",
"gte",
"lt",
"lte",
"in",
"not_in",
"contains",
"not_contains"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"input_schema": {
"type": "object",
"properties": {
"required": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,159}$"
}
},
"properties": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"array",
"object",
"number",
"integer",
"string",
"boolean",
"null"
],
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"examples": [
{
"input": {
"mode": "rulebook",
"context": {
"inputs": {
"proposed_amount_minor": 9000
}
},
"question": "Illustrative request only; not approved policy or authority to spend or execute.",
"rulebook": {
"rules": [
{
"outcome": {
"action": "record_only",
"verdict": "ALLOW",
"decision": "yes",
"reason_code": "WITHIN_EXAMPLE_LIMIT"
},
"rule_id": "within_limit",
"priority": 1,
"condition": {
"field": "proposed_amount_minor",
"value": 10000,
"operator": "lte"
}
}
],
"version": "1",
"rulebook_id": "example_amount_limit",
"schema_version": "rulebook_v1",
"default_outcome": {
"action": "record_only",
"verdict": "REVIEW",
"decision": "review",
"reason_code": "OUTSIDE_EXAMPLE_LIMIT"
}
}
},
"operation_id": "example_record_001"
}
],
"required": [
"operation_id",
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"mode",
"rulebook",
"context"
],
"properties": {
"mode": {
"type": "string",
"const": "rulebook",
"description": "Only the declarative Rulebook mode is available."
},
"context": {
"type": "object",
"required": [
"inputs"
],
"properties": {
"inputs": {
"type": "object",
"description": "The rulebook-specific input names and values. Supply required facts explicitly; agents must not invent them.",
"additionalProperties": true
}
},
"description": "Caller-supplied facts used by the supplied rules. Decide does not independently verify their real-world truth.",
"additionalProperties": false
},
"question": {
"type": "string",
"maxLength": 2400,
"description": "Optional context for the proposed check; it does not change the supplied rules."
},
"rulebook": {
"type": "object",
"title": "Decide Rulebook v1",
"required": [
"schema_version",
"rulebook_id",
"version",
"rules",
"default_outcome"
],
"properties": {
"rules": {
"type": "array",
"items": {
"$ref": "#/$defs/rule"
},
"maxItems": 100,
"minItems": 1
},
"version": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"rulebook_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_.:-]{1,119}$"
},
"input_schema": {
"$ref": "#/$defs/input_schema"
},
"schema_version": {
"const": "rulebook_v1"
},
"default_outcome": {
"$ref": "#/$defs/outcome"
}
},
"description": "Developer-supplied, approved declarative rules using the pinned Rulebook v1 contract.",
"additionalProperties": false,
"x-decide-condition-limits": {
"max_depth": 8,
"max_nodes": 256,
"max_children_per_combinator": 32
},
"x-decide-evaluator-version": "decide_rulebook_v1"
},
"binding_mode": {
"type": "string",
"const": "direct_declarative_rulebook",
"description": "Optional direct binding to the supplied rules; no executable policy code."
}
},
"description": "Complete Rulebook v1 request with policy-owner-approved rules and trusted facts. Preserve all fields for retries, summary reads and exports. Examples show structure only; Decide does not verify policy approval or real-world facts.",
"additionalProperties": false
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 160,
"minLength": 1,
"description": "Caller-generated proposal ID: 1-160 ASCII letters, digits, underscore or hyphen. Preserve it with the complete input before calling. Reuse for identical-input retries; changed input returns OPERATION_CONFLICT. Choose a new ID only for a genuinely new proposal, never to bypass a pending outcome or limit."
}
},
"additionalProperties": false
}