CitySignal

Up to six CitySignal picture cards for incidents in a city, including ones that already cleared: the frame a camera check kept, or a live view while the incident is still going. Each card has a headline, time, city, and a Cleared / Earlier today tag when it's over. Incidents with no picture are left out. Images in this tool's result are visible to the assistant only, not to the person. To show a card, give the person its picture_url as a tappable markdown link with a short label (road, cross street, time), e.g. [I-20 WB at US-29 (live)](picture_url). Never tell the person a picture is "shown" or "above." Describe what each image shows in one line next to its link. In apps that show CitySignal cards natively, the cards appear on their own; still add one line per card. If gallery_url is present, give it first as the one link that opens all cards. Show only CitySignal pictures for an incident (picture_url, gallery_url, placeholder_url): never add images from the web or any other source, not even as illustrations. Use for "show me what's happening," "any pictures," "what did it look like." hours (default 12, max 72) is how far back camera checks count.

city_pictures

Report mode: how every live CitySignal city is doing, in one call. The CitySignal Index for the last complete week (Sunday to Saturday): each city scored against its own typical week (Quiet, Typical, Busy, Heavy, with how many times typical), per category (roads, water, power, construction, transit), the biggest departure, week over week, plus what is live in each city right now. Use for reporters and anyone asking 'how is everything across cities', 'which city had the roughest week', 'compare Atlanta and Dallas this week'. Compare cities only by how far each is from its own typical week, never by raw counts: what each city publishes differs. Say when a city is Counting (not scored yet) or a category is Not covered. Cite it as the CitySignal Index and give index_url.

cities_report

Road cameras within a radius of a latitude and longitude (default 1 mile, max 5), nearest first, each with a link to its current still and whether it has live video; plus the camera checks CitySignal ran on alerts there in the last N hours (default 24, max 72): what the camera showed and whether it matched the alert. CitySignal does not record video, so footage of a past moment exists only as a check's saved frame, viewable in the signed-in app. Use for 'is there a camera on this spot', 'do we have footage of this', 'what did the camera show'. It does not geocode: resolve the place to lat and lon first.

city_cameras

Saves a spot (a place that matters to the connected person, where Scout looks out for them) at an address they typed, with a kind: home, work, school, church, gym or other, and an optional name. The address must resolve to one confident, house-level match in their home city; when it does not, nothing is saved and the result lists the top suggestions with their lat and lon. Then ask the person which one they meant and call save_spot again with that suggestion's lat and lon (never coordinates from anywhere else). Ten spots per account; a spot already within a tenth of a mile is reported, not duplicated. Call this only when the person asks to save a place. Needs a connected account.

save_spot

Scout's detour offers on the connected person's drives today, as the Scout page shows them: the streak line (how many drives or weeks straight home), the offer (worth it: an event they marked interest in, near a drive, as a stop; dodge it: a big crowd a drive passes, with the way around), the DETOUR-XXX code and what the code opens. The route's own state never changes because of an event. Use for 'any detours today', 'what is that DETOUR code', 'anything worth stopping for on the way home'. Empty when there is no offer. Needs a connected account.

my_detours

Week-over-week memory for a city: counts by category for the last 7 days and the 7 before, a plain-language read of the week, measured insights, where it concentrated (areas and corridors), why an unusual week was unusual, and what a newsroom published about it. Use for 'how has this week been', 'is this normal', 'where do outages keep happening'.

city_week

Events, concerts and home games coming up in a city within the next N days (default 7, max 14), with venue area, ticket price range and a ticket link when listed, and expected local traffic impact when known. Each event carries placeholder_url, a CitySignal summary card (not a picture) you may link as a tappable markdown link.

city_events

Resolves a DETOUR-XXX code for the connected person: which drive it is on, the event, whether it is worth it (a stop) or dodge it (a way around), the streak and offer lines, and the link that opens it. Codes are per person and per day; a code that has passed says so. Use when the person says or pastes a code. Needs a connected account.

get_detour

Four weeks of what happened in a city, sorted by kind, for one category. roads (default): crashes, stalled vehicles, hazards and debris, closures, vehicle fires. power: outages by size (one home, small, neighborhood, large), planned outages, downed or sparking lines. transit: delays, canceled trips, reduced service, detours, stop and station changes, planned work. roadwork: lane, ramp and full road closures. water: main breaks and leaks, outages and shutoffs, boil water advisories. Reports that did not say are counted as Type not given. With the busiest and quietest hours of the week, each day of the week's average (by_weekday, busiest_weekday) and each hour of the day's average (by_hour, busiest_time), the full hour-of-the-week grid (hour_grid) and a count for every day (daily), how many new ones a typical instance of an hour sees (pass hour_of_week, or it uses the current hour in the city), the median time until it ended by kind, the places with the most, and for roads how much of the road they took. Use for 'what kind of incidents does Atlanta get', 'when are crashes worst in Dallas', 'how long do Houston power outages last', 'is transit worse on Mondays in Chicago', 'which day of the week has the most incidents', 'what time of day is worst', 'how much night roadwork does Seattle do'. Compare cities by mix and timing, never raw totals: what each city's reports cover differs. Cite it as the CitySignal Index and give page_url.

city_incidents

Live alerts in a city, deduplicated from official feeds (roads, transit, weather, power, water, construction) and placed by the app's own rule into four buckets: now (live and current), ongoing (live for more than two days, or unconfirmed), ahead (starts later, within 7 days, grouped by day) and recap (ended in the last 12 hours). Each item carries a stable signal_id. Use this for any 'what is going on in <city>' or 'anything I should know before I head out' question. Events and games are in city_events. Items with a real picture carry picture_url. Images in the result are visible to the assistant only: give the person picture_url as a tappable markdown link next to the item. Never say an image is shown. Show only CitySignal pictures for an incident (picture_url, gallery_url, placeholder_url): never add images from the web or any other source, not even as illustrations. In apps that show CitySignal cards natively, the cards appear on their own; still add one line per card.

city_now

Open errands and list items of people in the connected person's Circle, for people who turned on assistant access for them, with how long each has waited and whether it was already asked of or accepted by the connected person. When an errand lists what it is for, 'items' names them (a 'Groceries' errand with items oat milk, eggs, paper towels): name those items in the answer. An empty 'items' means no items are shared for that errand. Use for 'what does everyone need', 'what has Mom asked for', 'did anyone already get the milk'. People who did not turn on access do not appear. Needs a connected account with Circle access.

circle_needs

Trips people in the connected person's Circle already plan today or tomorrow that fit an errand: a store run someone's item could ride along on, a return or post office stop, a trip they both make. Returns the person's first name, the trip label, an approximate time only if they share times, the kind of store, and which of the connected person's items could ride along. Never a location. Use for 'is anyone passing a pharmacy today', 'who could grab the milk', 'anyone going to Target'. Asking the person happens in the CitySignal app. Needs a connected account with Circle access.

circle_along_the_way

The connected CitySignal account: a stable opaque id and display name. Call this to confirm which account is linked before reading personal tools.

get_profile