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.

Cloudflare Workers
Agents SDK
Durable Objects
Workers AI
Llama 3.3 70B
TypeScript

How Clara Works

  1. Report the problem

    Describe symptoms or paste output from ping, traceroute, nslookup, or ipconfig. Clara starts building an incident model immediately.

    $ describe the problem or paste command output…
  2. 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
  3. 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.