Heartbeat — dead-man switch for cron jobs & AI agents

{'type': 'object', 'required': ['name'], 'properties': {'kind': {'enum': ['push', 'pull', 'selfcheck'], 'type': 'string', 'default': 'push', 'description': 'push = you ping us; pull = we probe target_url every min(period_s,60)s; selfcheck = your box runs our egress-trust probe script and POSTs verdict reports to the ping URL'}, 'name': {'type': 'string', 'description': 'unique name, 1-40 chars [A-Za-z0-9_.-]'}, 'grace_s': {'type': 'integer', 'default': 300, 'description': 'extra seconds of slack before DOWN (0-86400)'}, 'pass_key': {'type': 'string', 'description': 'Pro pass key from a $5 USDC payment (optional; skips rate limits)'}, 'period_s': {'type': 'integer', 'default': 300, 'description': 'expected seconds between pings (60-86400)'}, 'depends_on': {'type': 'array', 'items': {'type': 'string'}, 'description': 'parent monitor names and/or gate:<gate-name> entries (max 5). When a parent is DOWN or a gate parent is HALT this monitor becomes DEGRADED-BY-UPSTREAM: notified once, own silence paging suppressed until the parent recovers.'}, 'target_url': {'type': 'string', 'description': 'public http(s) URL to probe (pull only)'}, 'webhook_url': {'type': 'string', 'description': 'public http(s) URL that receives UP/DOWN alerts (optional)'}}}

{'type': 'object', 'properties': {'key': {'type': 'string', 'description': 'monitor key (private lookup; also returns ping/fail URLs)'}, 'name': {'type': 'string', 'description': 'monitor name (public lookup)'}}}

{'type': 'object', 'properties': {'key': {'type': 'string', 'description': 'optional monitor key; adds the private ping_url/fail_url for that one monitor'}}}

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'monitor key returned by create_heartbeat'}, 'endpoints': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'tls_ms': {'type': 'integer'}, 'verdict': {'enum': ['trusted', 'rate_limited', 'error', 'challenged'], 'type': 'string'}, 'status_code': {'type': 'integer'}, 'cf_mitigated': {'type': 'boolean'}}}, 'description': 'selfcheck monitors only: one object per probed surface, e.g. {"name":"claude-session","status_code":200,"cf_mitigated":false,"tls_ms":230}'}}}

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}}}