| action | Yes | Type of action claimed: 'email_sent', 'http_request', 'file_written', 'db_insert', 'pr_created', 'payment_processed', 'message_sent', 'api_call', 'task_completed', 'data_exported', 'notification_sent', 'custom' | |
| target | Yes | Target of the action — what was acted upon. Examples: 'user@example.com' (email), 'https://api.example.com/endpoint' (http), '/opt/data/report.pdf' (file), 'usage_log' (db table) | |
| metadata | No | Optional verification context. For http_status: {expected_status: 200, method: 'GET'}. For file_exists: {expected_hash: 'sha256...'}. For db_row_exists: {where_column: 'id', where_value: '123'}. | |
| ttl_hours | No | Hours until claim expires if not verified (default 24, max 168) | |
| agent_name | No | Name of the agent making the claim (e.g., 'marketing-agent') | |
| session_id | No | Optional observability session_id to link this claim to a trace | |
| evidence_type | Yes | How to verify the claim: 'http_status' (check URL response), 'file_exists' (check file path), 'db_row_exists' (check database row), 'webhook' (wait for callback), 'smtp_delivery' (check email delivery), 'manual' (flag for human review) | |