NETWORK
TROUBLESHOOTING
THAT REMEMBERS.
Clara is a stateful AI agent that builds an incident model as you troubleshoot. Unlike a stateless chatbot, Clara tracks connectivity facts, reconciles contradictions, and updates its hypotheses with every message.
- Upstream connectivity issue
- WAN / default-route not configured
How Clara Works
-
Report the problem
Describe symptoms or paste output from
ping,traceroute,nslookup, oripconfig. Clara starts building an incident model immediately.$ describe the problem or paste command output… -
Evidence reconciles
Each message updates the incident state. Contradictions are resolved, tests are deduped by type and target, and the hypothesis list is replaced in full each turn.
connectivity → testsPerformed → hypotheses → nextStep -
State survives sessions
Each browser session maps to a dedicated Durable Object with its own SQLite database. Close and reopen the browser and your incident is waiting exactly where you left it.
getAgentByName(sessionUUID)
The incident model
Clara doesn’t just generate text. It maintains structured incident state that the Inspector panel exposes in real time.
Connectivity fields are updated only when explicit evidence exists in the current message. Fields with no new evidence are preserved from prior turns.
The hypothesis list is replaced in full each turn. No stale hypotheses survive new evidence.
messages
full conversation history
connectivity
gateway { address?, status }
internetIp { address?, status }
dns { status }
testsPerformed
latest result per type+target
{ type, target?, result, summary }
hypotheses
current plausible causes, replaced each turn
nextStep
single most useful next action
Architecture
Each browser session generates a UUID mapped via getAgentByName from the
Cloudflare Agents SDK to one FlareTraceAgent Durable Object instance with its own
isolated SQLite database. Different sessions produce different instances with no shared state.