watch_site
Report only the acquisitions new since the last check of this site.
SAR's value for monitoring is its cadence, so the natural workflow is
*standing*: run the same search each time and act only on what changed. This
tool packages that idempotent delta — call it in one turn, come back a day
(or a session) later and call it again, and it returns just the passes
published in between, not the whole list again. The scheduler is you: ask the
agent to check the site, and it reports the delta.
Define the site with the same filters as ``search_catalog`` — ``place``
(geocoded to a bbox), ``area`` (task/site-name substring, loosened by
``fuzzy``), ``bbox``, ``products``, and ``start``/``end`` date bounds. The
watch is identified by a stable ``name`` derived from those filters (pass an
explicit ``name`` to run several independent watches over the same site);
``reset=True`` re-establishes the baseline, reporting everything as new.
State persists in the local catalog index's ``meta`` table (created on first
use), so a watch survives across sessions with no extra setup. ``local``
selects the search backend exactly as in ``search_catalog`` — leave it unset
to use the on-disk index when present and a live S3 walk otherwise; for true
monitoring a live walk (``local=false``) catches freshly published passes.
**No model is called** — this is pure set arithmetic over the deterministic
search — and the returned ``new_items`` are context cards ready to hand
straight to ``change_composite`` / ``timescan``, closing the standing-analyst
loop (new pass → composite → describe) without leaving the conversation.
On the public host (``umbra serve --public``, COG streaming off) nothing
is stored. Every call reports the current matches as new, says so in
``note``, and caps ``new_items`` at 50 (``new_total`` is the full count).
The watch name is capped at 128 characters. A local server still persists
the baseline in the index.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "watch_site"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive acquisition-date upper bound. Same grammar as search_catalog end. | |
| area | No | Task-name substring. With fuzzy, a loose token match. | |
| bbox | No | WGS84 [min_lon, min_lat, max_lon, max_lat]. When set, place is not geocoded. | |
| name | No | Stable watch id. Omit to derive one from the filters. The public host keeps at most 128 characters. | |
| fuzzy | No | Loose task-name match for area. No model call. | |
| local | No | True uses only the local index; False forces a live walk. Omit to use the index when present. True cannot be combined with a Canopy token. | |
| place | No | Free-text place. Geocoded to a bbox only when bbox is omitted. | |
| reset | No | True discards the stored baseline and reports every current match as new. Default false. | |
| start | No | Inclusive acquisition-date lower bound. Same grammar as search_catalog start. | |
| products | No | Keep items that expose one of these types (GEC, CSI, SIDD, SICD, CPHD). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||