session.syncshot()

Manually refresh a local Session's base system from the Agent's current configuration

A local Session fixes its base system in memory on first assembly. To explicitly adopt the Agent's latest instruction, managed system blocks, and power system text, call:

await session.syncshot();

syncshot() replaces the Session's in-memory base system snapshot. A provider request already in flight is unaffected; later steps use the new base instructions. It refreshes only the system and does not change the Session's power execution view.

The Composer's context_system_blocks are excluded from freezing and persistence. Later model requests and session.system() previews still append the latest dynamic context, including the current checkpoint summary, after the base snapshot. Summary updates themselves require no syncshot() call.

With the default store, persistence depends on whether session_state.system_snapshot already has a value:

  • Existing persisted snapshot: replaced with the regenerated base system.
  • No persisted snapshot: only memory is updated; no persisted snapshot is created automatically.

To persist the base snapshot for the first time, explicitly persist after refreshing:

await session.syncshot();
await session.snapshot();

syncshot() and snapshot() run serially within one Session so concurrent writes have deterministic ordering. This method is available only on local AgentSession; remote Sessions do not expose it.