Topology Freshness is the safety primitive that stops agents from acting on a stale picture of the world. If the topology view (Container Graph, Service Map) is older than the freshness threshold, high-risk actions are blocked. The agent has to wait for the map to refresh, or fall back to suggest mode.
Topology refreshes happen continuously, but cloud APIs rate-limit and ingestion has lag. A 4-minute-old container graph might miss a new pod that just started serving traffic. An agent that decides "rds-prod has no live consumers" might be wrong by 4 minutes worth of new pods. Freshness threshold is the line where we stop trusting the picture for high-risk decisions.
Not every action needs the freshest map. A SELECT query is fine on a 10-minute-old graph; a DROP TABLE is not. Each action class has a freshness requirement: read-only is loose, mutating is strict, destructive is strictest. Agents proposing strict actions on stale topology get blocked at the gate.
During an incident, operators can force a refresh on any source. The page shows the refresh button per source with the last-refresh timestamp. Force refresh kicks the ingestion pipeline, returns once the source is fresh, and unblocks any pending agent actions in one go.
The page reports weekly: blocked-action count per source, top services blocked, average wait time for refresh. A high block rate is a tuning signal, either thresholds are too strict, or an upstream API is too slow. Use the report to right-size your freshness policy.
Subscribe to Nova AI Ops on YouTube for demos, tutorials, and feature deep-dives.
A small primitive that prevents a class of incidents nobody talks about: agents acting on the world as it was, not as it is.