04 / Illustrative definition
The current contract is visible in the project.
This abridged example uses the current schema-version key and shows the exact six-field Animal Patrol output shape. It is explanatory source, not evidence of a verified run.
animal-patrol.json
Abridged illustration{
"agent_definition_schema_version": "2026-03-03.r1",
"inputs": [
{
"type": "text",
"text": "Inspect exactly one supplied garden image and return one finding."
}
],
"runtime_vars": {
"output_csv_path": {
"type": "string",
"default": "data/animal-patrol.csv"
}
},
"agent_schema": {
"type": "object",
"properties": {
"image_name": { "type": "string" },
"animal": { "type": "string" },
"count": { "type": "integer", "minimum": 0 },
"confidence": { "type": "number", "minimum": 0, "maximum": 1 },
"garden_risk": {
"type": "string",
"enum": ["none", "low", "medium", "high", "unknown"]
},
"notes": { "type": "string" }
}
},
"actions": [
{
"name": "record_finding",
"logic": { "!=": [{ "var": "image_name" }, ""] },
"run": [
{
"kind": "tool",
"name": "animal_finding_recorder",
"params": {
"image_name": { "var": "image_name" },
"animal": { "var": "animal" },
"count": { "var": "count" },
"confidence": { "var": "confidence" },
"garden_risk": { "var": "garden_risk" },
"notes": { "var": "notes" },
"output_csv_path": { "var": "runtime.output_csv_path" }
},
"output_variable": "record_result"
}
]
}
]
}Current local validation surfaces
cargo ai tools lint animal_finding_recorder
cargo ai tools check --config ./animal-patrol.json
cargo ai hatch animal-patrol --config ./animal-patrol.json --checkThese commands inspect source/scaffold conformance, exercise the tool contract, and validate the agent compile path. They do not replace a real one-image run with a compatible profile.