Skip to main content
The Sessions view shows every conversation your agents have had. You can search for specific sessions, filter by agent or channel, review full conversation histories, and manage sessions with actions like reset, compact, export, and delete. Who it’s for: anyone investigating a single conversation — whether to audit what an agent did, debug a stuck session, or extract a transcript for analysis.

​
Routes

  • /sessions — session list
  • /sessions/:key — session detail (URL-encode the session key, which can contain colons and slashes)

​
Backing RPC

  • session.list — list (filterable by tenant, agent, channel)
  • session.status(key) — detail with messages, token usage, cache metrics
  • session.delete(key) — delete
  • session.reset(key) — clear conversation history
  • session.compact(key) — summarize older messages
  • session.export(key) — JSONL transcript download
Refresh is on demand; the view does not poll.

​
What You See

​
Session List

The main view displays a filterable table of all conversation sessions. At the top, you will find:
  • Search box — type to filter sessions by session key, agent name, or channel type.
  • Agent dropdown — show sessions for a specific agent or all agents.
  • Channel dropdown — show sessions from a specific channel (Telegram, Discord, Slack, etc.) or all channels.
The table displays sortable columns with information about each session. Click the checkbox next to any row to select it for bulk operations.

​
Bulk Operations

When you select one or more sessions, a bulk operations bar appears with three actions:
  • Reset Selected — clears conversation history for the selected sessions. A confirmation dialog appears first.
  • Export Selected — downloads the selected sessions as a file.
  • Delete Selected — permanently removes the selected sessions. A confirmation dialog appears first.
Click any row (not the checkbox) to open the full session detail view.

​
Session Details

When you click a session row, you navigate to the detail view for that session. The detail view is organized as a breadcrumb + info bar + actions bar at the top, followed by a 3-tab layout (Conversation / Context State / Metrics) that lets you focus on the data you care about.

​
Session Info Bar

A summary bar at the top displays key information about the session:
  • Agent — which agent handled this conversation.
  • Channel — which platform the conversation took place on.
  • Messages — total number of messages in the session.
  • Tokens — total token usage for the session.
  • Created — when the session was first started.

​
Action Buttons

Below the info bar, four action buttons let you manage the session:
  • Reset — clears all conversation history. The agent will start fresh with no memory of previous messages in this session.
  • Compact — summarizes older messages to save space while keeping the essential context. Useful for long-running sessions.
  • Export JSONL — downloads the full session as a JSONL file for backup or analysis.
  • Delete — permanently removes the session and all its conversation history.

​
Conversation Tab

The default tab. A scrollable area shows the full conversation with role-based styling:
  • User messages appear with a neutral background.
  • Assistant messages appear with an accent border on the left.
  • System messages appear centered in italics.
  • Tool calls appear as expandable cards with the tool name as a header and the input/output below.
  • Compaction markers appear inline at points where the context was compacted.
Each message includes a timestamp.

​
Context State Tab

Lazy-loaded on first activation. Shows the session’s current context state:
  • A token budget segment bar breaking down how the budget is split across system prompt, tools, context, and messages.
  • A per-execution pipeline waterfall with per-layer timing, useful for spotting context-assembly bottlenecks.

​
Metrics Tab

Lazy-loaded on first activation. Shows session-level statistics:
  • Input Tokens — tokens used by incoming messages.
  • Output Tokens — tokens used by agent responses.
  • Tool Calls — how many tools the agent invoked during this session.
  • Compactions — how many times the session has been compacted.
  • Resets — how many times the session has been reset.
  • Cost — session-level spend rolled up from billing data.

​
Common Tasks

1

Find a specific session

Use the search box at the top of the session list. Type any part of a session key, agent name, or channel type to filter the table instantly.
2

Export session history

Select one or more sessions using the checkboxes, then click Export Selected in the bulk operations bar. A file downloads automatically.
3

Reset a session

Click a session to open the detail view, then click Reset. Confirm the action in the dialog that appears. The conversation history is cleared and the agent will start fresh in this session.
4

Compact a session

Click a session to open the detail view, then click Compact. Confirm the action in the dialog. Older messages are summarized into a shorter form, freeing up space while preserving the important context.
Reset vs Compact:
  • Reset clears everything — the agent gets a completely fresh start with no memory of previous messages in this session.
  • Compact summarizes old messages — the agent keeps the essential context but the detailed history is condensed to save space.
Use Reset when you want a clean slate. Use Compact when a session has grown large and you want to keep the conversation going without losing important context.
Deleting a session permanently removes all conversation history and cannot be undone. If you want to keep the data, export the session first.

Chat Console

Have real-time conversations with your agents through the browser.

Agents View

View, configure, and manage your AI agents.