Skip to content

History

Will hold historical events for the scene.

There are three types of historical entries:

  • Archived history (static) - These are entries are manually defined and dated before the starting point of the scene. Things that happened in the past that are IMPORTANT for the understanding of the world. For anything that is not VITAL, use world entries instead.
  • Archived history (from summary) - These are historical entries generated from the progress in the scene. Whenever a certain token (length) threshold is reached, the Summarizer Agent will generate a summary of the progression and add it to the history.
  • Layered history (from summary) - As summary archives are generated, they themselves will be summarized again into compressed layers, creating a detail gradient from full detail (recent) to highly compressed (oldest). See Layered History for details.

History

Managing entries

  • All entries can be edited by double-clicking the text.
  • Static entries can be deleted by clicking the Delete button.
  • Summarized entries can be regenerated by clicking the Regenerate button. This will cause the LLM to re-summarize the entry and update the text.
  • Summarized entries can be inspected by clicking the Inspect button. This will expand the entry and show the source entries that were used to generate the summary.

Adding static entries

Static entries can be added by clicking the Add Entry button.

Static entries must be older than any summary entries

Static entries must be older than any summary entries. This is to ensure that the history is always chronological.

Trying to add a static entry that is more recent than any summary entry will result in an error.

Entry Text

The text of the entry. Should be at most 1 - 2 paragraphs. Less is more. Anything that needs great detail should be a world entry instead.

Unit

Defines the duration unit of the entry. So minutes, hours, days, weeks, months or years.

Amount

Defines the duration unit amount of the entry.

So if you want to define something that happened 10 months ago (from the current moment in the scene), you would set the unit to months and the amount to 10.

Add Static Entry

Time Passage Entries

New in 0.36.0

The history view now displays time passage entries with editable duration fields. You can double-click a time passage entry to edit its duration (amount and unit), or delete it entirely.

For more details on managing time passages, see the Time Passage Management documentation.

Compression Statistics

The history tools menu displays layered history compression statistics for each layer. See Layered History -- Compression Statistics for details.

Regenerate everything

It is possible to regenerate the entire history by clicking the Regenerate All History button in the left sidebar. Static entries will remain unchanged.

Regenerate All History

This can take a long time

This will go through the entire scene progress and regenerate all summarized entries.

If you have a lot of progress, be ready to wait for a while.

Reset Scene State

For more comprehensive reset options beyond regenerating history, see the Reset Scene State dialog, which provides granular control over resetting history, context DB, agent states, and other scene components.