A session is a single investigation conversation within a project. Each session has its own conversation log, key results, and optional disposition.
Starting a Session
From a project detail page, click New Session. You will be prompted to:
- Optionally define a disposition schema if you want the session to produce a structured determination at the end (see Dispositions).
- Optionally add dependencies on other sessions in the project (see Dependencies).
- Describe what you want to investigate (the starting request).
- Click Start Session.
The AI receives your starting request along with the project's system prompt, tool instructions, any disposition schema context, and any upstream dependency context, then begins its investigation.
The Conversation Loop
The AI works through your request by making tool calls — querying the database, looking up metadata, searching the data model — and reporting back. Each tool call appears in the conversation as a collapsible message showing what the AI did and the result. The AI continues making tool calls until it has enough information to present findings to you.
The AI can use multiple tools in a single response (up to 5), executing them in parallel. For example, it might run several database queries at once, or promote a result while starting a new query. Each parallel tool call appears as its own entry in the conversation. The only restriction is that PROMPT_USER (which returns control to you) must be used alone.
A session can involve up to 35 iterations. If the AI approaches this limit, it is prompted to wrap up its investigation and ask the user for feedback.
Interrupting a Session
While the AI is working (making tool calls and processing results), the session owner can click the Interrupt button to stop the AI mid-investigation. The button appears next to the "Thinking..." indicator whenever a session is actively running.
When interrupted, the AI stops at its next tool call boundary, acknowledges the interruption, and asks how you would like to proceed. The session remains open — you can give the AI new instructions, redirect the investigation, or ask it to wrap up.
Only the session owner can interrupt a session.
Following Up
After the AI presents its findings, you can type follow-up questions or requests in the input area at the bottom of the workspace. The AI picks up the full conversation context and continues the investigation.
Session Status Indicators
On the project detail page, each session displays contextual information alongside its name:
- Last updated date — The date the session was last modified.
- Key result count — Shows the number of key results (e.g., "3 key results") if any have been promoted.
- "(Not started)" — Shown for sessions that have no conversation log yet, indicating the session was created but no AI conversation has taken place.
Processing Time
Each session tracks the total time spent on AI processing. This is the cumulative wall-clock time across all exchanges in the session (each time the AI works through tool calls and returns a response). The total processing time is displayed at the bottom of the conversation workspace, near the AI disclaimer, and updates in real time after each exchange.
Session Management
From the project detail page, you can:
- Reorder sessions by dragging the grip handle that appears when you hover over the left edge of a session row. The new order is saved automatically when you drop.
- Rename a session using the pencil icon.
- Delete a session from the edit panel. If other sessions depend on this session, the confirmation dialog will warn you.
- Edit the disposition schema for a session (see Editing a Schema After Creation).
- Edit dependencies for a session (see Adding Dependencies).