dsh-memory-spaces

Configuration

Field	Default	Meaning
databasePath	Required; bundle uses profile:memory-spaces-v4.sqlite	Installed packages resolve the file under the owning DSH Profile. :memory: is accepted for tests.
journalMode	wal	SQLite journal mode: wal, delete, truncate, or persist.
busyTimeoutMs	5000	Wait for a locked database before failing an operation.
maxMemoryBytes	8192	Maximum UTF-8 bytes in one memory version.
maxQueryBytes	4096	Maximum UTF-8 bytes retained from direct user input for retrieval.
maxRecallItems	8	Maximum ranked candidates considered for preview and injection.
maxRecallBytes	16384	Complete warning, JSON provenance, and memory-content byte limit.
historySummaryProvider	Empty	Fixed summary provider; empty uses the Session's latest route and must pair with the model field.
historySummaryModel	Empty	Fixed summary model; empty uses the Session's latest route and must pair with the provider field.
historySummaryMaxTokens	1200	Maximum summary output tokens; token-truncated output is not saved.
maxHistoryImportBytes	65536	Maximum bounded transcript bytes sent to the summary model.

Schema version 4 stores independent source and consumer tables. A version 3 database placed at the configured target path is backed up and migrated as follows: read becomes automatic consumption; write becomes a source; read_write becomes both; manual_only becomes a source plus confirmation consumption. The new default does not silently reuse a legacy global $DSH_HOME/memory-spaces-v3.sqlite; follow Backup and recovery for an explicit move. Other unknown schema versions fail closed without changing the journal mode.