Watch a repo, package, endpoint or agent for a Preflight verdict change
onchain_agent_watchUSE WHEN an agent (or the person it works for) wants to be told if something in its stack stops checking out — rather than re-running a Preflight on a schedule of its own. Goes through the SAME path the public form uses: same validation, same normalisation, same rate limit, one row per address and target.
WHAT HAPPENS: the target is re-checked once a day by the public Preflight path, and an email is sent ONLY when the verdict CHANGES. Never on a schedule, never a digest. A transition INTO unknown (a check that failed to run) is recorded and never mailed — a failed check is not news about the target. wallet: get told when Sato Scan sees address poisoning aimed at that wallet.
FREE WHILE IN PREVIEW. No price is set and no payment is taken.
WHAT IS STORED: the normalised target, the address (a notice has to be delivered), an HMAC of it for counting, and the baseline verdict. No IP address and no name. Asking twice is idempotent; action: "unsubscribe" stops the mail and answers the same way whether a row existed or not.
RULE ENFORCED: a verdict describes what was checked and when. It is not a safety, security or returns judgment, and a CHANGE is a change in what was observed — not a warning.
Returns (json): { ok, action, target_kind, target, watch_id, verdict, notice, caveat }.
Example: { target_kind: "package", target: "solana-agent-kit", notify_to: "me@example.com" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | subscribe (default) arms the watch; unsubscribe stops the mail for this address and target. | |
| target | Yes | The thing itself, in the spelling that kind takes. It is normalised, so two spellings of one repository become one watch. | |
| notify_to | Yes | The email address the change notice goes to. Stored once for delivery and counted by an HMAC; it never enters telemetry or logs. | |
| target_kind | Yes | What is being watched: repo (owner/name or a GitHub URL), package (npm name), endpoint (an https URL), agent (an ERC-8004 reference like 'base:42'), wallet (<Chain>:<address>, e.g. 'Base:0x...'). | |
| response_format | No | Text format; structuredContent is JSON either way. | markdown |