Skip to main content

In plain terms

A session is one chat thread.
  • Same sessionId → the agent remembers earlier turns.
  • New / missing sessionId → a brand-new chat (it forgets).
There is no storage field on Agent. Sessions live inside memory: { storage }.
Save result.sessionId if you let Agentium pick a random one. Full story: Memory → Sessions.

How long is the thread?

There is no numHistoryRuns or maxContextTokens on Agent. Those names were old and wrong. When old messages fall off, summaries (on by default) keep a short recap.

Sticky notes on the thread

Tools and hooks can stash numbers on the session:

SessionManager (advanced)

Use this if you are building a chat UI and need to list / search threads yourself.
On an agent, searchPastSessions: true gives the model a search_past_sessions tool.

Which drawer?