Skip to content

Sessions

A session is one conversation with an agent. It is kept on the user's device, not on the server.

On the device

Each session is an append-only transcript: the messages, the tool calls and their results, the approvals, and the outcome of each turn.

SDK Where Protection
.NET A folder of the signed-in user in the local application data On Windows each entry is encrypted for the user with DPAPI. On macOS and Linux, Fadenstack.Secrets keeps the key in the Keychain or the Secret Service and the entries are encrypted with it; without a key store the transcripts stay in memory and are not written.
TypeScript, in a browser IndexedDB of the extension or page, one database per signed-in user Encrypted with AES-GCM under a key the browser holds and script cannot read. Only that extension or origin can use it.
TypeScript, elsewhere Memory, unless you give it a store Yours to decide

Per user. The stores belong to the signed-in user, not to the device or the browser profile: two people who share a computer or a profile never see each other's sessions, "Allow always" choices or thinking level.

By default the newest 50 sessions are kept, none older than 90 days. A session can be continued later, in the tool mode it was left in. Both SDKs let you plug in your own store.

The server can only tighten the limits. An agent's profile may carry local_retention with maxSessions and maxAgeDays. The SDK keeps the stricter of the app's limit and the server's, for each, and the server cannot raise a limit above the app's. This applies to the store the SDK keeps, not to one the app passes in.

Export and delete my data

Both SDKs let the app offer the person their rights over what the device holds: an export of all their sessions and "Allow always" choices (GDPR Art. 15 and 20), and a deletion of them (Art. 17). A store the app passed in itself is not deleted, because it may hold other people's data; the result says so. Neither touches what the server keeps, nor signs the person out. See the SDK pages: .NET (ExportMyDataAsync, DeleteMyDataAsync) and TypeScript (exportMyData, deleteMyData).

What the server sees

The SDK reports the agent's events to the server: which tools ran, how long they took, the outcomes and the approval decisions. These events carry no message content.

The model requests themselves pass through the server, like every request, and there the organisation's settings for personal data, usage records and audit apply. See Personal data.