From 569aeafd016fbf169d03b820b77ff13bf519b317 Mon Sep 17 00:00:00 2001
From: Misha Bragin <bangvalo@gmail.com>
Date: Wed, 1 Jul 2026 16:32:51 +0200
Subject: [PATCH] Add Agent Network access log session view (#822)

---
 .../usage-and-logs/access-logs.mdx            | 40 ++++++++++++++++++-
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/src/pages/agent-network/usage-and-logs/access-logs.mdx b/src/pages/agent-network/usage-and-logs/access-logs.mdx
index 5365c30b..bb666e53 100644
--- a/src/pages/agent-network/usage-and-logs/access-logs.mdx
+++ b/src/pages/agent-network/usage-and-logs/access-logs.mdx
@@ -1,5 +1,5 @@
 export const description =
-  'The per-request Agent Network access log: caller identity, provider, model, tokens, cost, decision, and reason, with server-side filtering.'
+  'The per-request Agent Network access log: caller identity, provider, model, tokens, cost, decision, and reason, with server-side filtering and a grouped-by-session view.'
 
 # Access Logs
 
@@ -22,6 +22,41 @@ and the reason a request was allowed or denied.
 - **Status** and **Reason** — for denials, the mapped policy reason; for
   allowed requests, a link to the policy that authorized it.
 
+## Sessions
+
+Use the **Requests / Sessions** switch above the log to change the view. The
+**Sessions** view groups related requests into a single session and shows one
+row per session, most recent activity first — so you can see the latest sessions
+at a glance.
+
+<p>
+    <img src="/docs-static/img/agent-network/usage-and-logs/agent-network-access-log-sessions.png" alt="agent network access logs grouped by session" className="imagewrapper-big" />
+</p>
+
+Some agents keep a session across many separate calls — for example,
+[Claude Code](/agent-network/integrations/claude-code) tags every request in a
+coding session with the same session id. Agent Network groups those requests
+together, so a whole session shows up as one row with its totals instead of
+dozens of individual entries.
+
+Each session row summarizes:
+
+- **Activity** — the session's time span, from its first request to its last.
+- **User / Agent** and **Auth Group** — the caller and the authorizing groups.
+- **Provider** — the provider and the model(s) used (e.g. `2 models`; hover to
+  see the full list).
+- **Requests** — how many requests the session made, and over what duration.
+- **Tokens** and **Cost** — summed across the whole session.
+- **Reason** — the session's policy decision; a denial if any request in the
+  session was blocked.
+
+Expand a session to see its individual requests — each with its timestamp, path,
+status, duration, model, tokens, and cost — and expand a request for its full
+detail (including the prompt and response when prompt capture is on).
+
+Requests from agents that don't set a session id each appear as their own
+single-request row.
+
 ## Filtering
 
 <p>
@@ -37,7 +72,8 @@ Filter the log by:
 - **Model**
 - **Path** — match requests whose path starts with a given prefix (e.g. `/v1/messages`).
 
-All filtering is applied server-side.
+All filtering is applied server-side and works in both the Requests and Sessions
+views.
 
 ## Availability