# AgentTraffic

**Kind:** Interface

**Source:** [`atloria-monorepo/apps/api/src/events/agent-analytics.service.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/apps/api/src/events/agent-analytics.service.ts#L15)

Agent-native analytics — "who/what AI is reading your docs".

A read-side aggregation over the `agent_read` interaction_events the public agent
surfaces (llms.txt / llms-full.txt / .md twins / MCP) already record via EventsService.
No new capture. Mirrors ManualsInsightsService.deflection: one org-scoped fetch, JS
aggregation, a zero-filled daily trend. The `refusedQuestions` panel folds in the
`chat_refused` signal — the loop-closer: what agents/users asked that the docs
couldn't answer.

## Properties

| Property | Type |
|---|---|
| `windowDays` | `number` |
| `total` | `number` |
| `byAgent` | `Array<{ agent: string; count: number }>` |
| `bySurface` | `Array<{ surface: string; count: number }>` |
| `topPages` | `Array<{ path: string; count: number }>` |
| `trend` | `Array<{ date: string; count: number }>` |
| `refusedQuestions` | `Array<{ question: string; count: number }>` |