Domain Sentinel monitors domain names with deterministic evidence rules. It can read local domain lists, query configured technical sources, keep a local state, generate reports, and create alerts only when a confirmed change is detected.
The pack does not invent availability, prices, marketplaces, API keys, or buying advice. If evidence is missing, vague, or conflicting, the output stays unknown or conflicting and asks for re-verification.
Availability and prices that are not verified by reliable sources remain unconfirmed in both machine output and user-facing reports.
Quick start
bash install.sh
python3 agent.py --help
python3 agent.py run --once --dry-run
python3 agent.py check example.com --dry-run
python3 agent.py generate-names "agent capability packs"
python3 agent.py purchase-guard example.com --provider registrar-name --max-price 12.50 --currency USD
python3 agent.py report
python3 agent.py status
Dry-run skips external paid actions and remote mutations. It may still use local
manual evidence from examples/manual_sources.example.json.
Evidence rules
Allowed proof sources are RDAP or WHOIS, official registrar APIs, official marketplace APIs, explicitly verified sale pages, and user-provided manual sources. DNS absence, ping failure, an empty website, vague search results, and LLM suggestions are never treated as proof.
If a source says a domain is listed but does not provide a numeric price, Domain
Sentinel reports UNKNOWN_PRICE. If reliable sources disagree on availability
or price, it reports CONFLICTING_SOURCES.
Purchase safety
No automatic purchase, bid, registration, renewal, or checkout is included in
v1. The purchase-guard command only validates a future-confirmation phrase and
always returns purchase_executed: false.
Any future purchase-capable version must block unless the user supplies this exact phrase:
CONFIRM_PURCHASE domain=<domain> provider=<provider> max_price=<amount> currency=<currency>
API keys are read from environment variables such as REGISTRAR_TOKEN and are
never written to state, reports, alerts, or logs by the deterministic core.