Skip to main content

Interface: SqlCheckpointStoreOptions

Defined in: packages/agentos/src/orchestration/checkpoint/SqlCheckpointStore.ts:94

Options of SqlCheckpointStore.

Properties​

db​

db: StorageAdapter

Defined in: packages/agentos/src/orchestration/checkpoint/SqlCheckpointStore.ts:100

The store the table lives in: an adapter of its own or the product's own, never AgentOS's provenance-wrapped storage adapter, whose write hooks can turn a run() into a no-op. A save the adapter reports writing no row rejects.


ensureSchema?​

optional ensureSchema: boolean

Defined in: packages/agentos/src/orchestration/checkpoint/SqlCheckpointStore.ts:114

Create the table and its indexes when the table is missing (see SqlCheckpointStore.ensureSchema). Default true. With false the store runs no DDL: the product's own migrations make the table from checkpointDdl.


tablePrefix?​

optional tablePrefix: string

Defined in: packages/agentos/src/orchestration/checkpoint/SqlCheckpointStore.ts:109

The table's name, and the start of its indexes' names (idx_<prefix>_*). Default agentos_checkpoints. Stores under different prefixes keep their checkpoints apart in one database; stores under one prefix share them.

A lower-case letter, then at most 52 lower-case letters, digits or underscores, so that idx_<prefix>_graph fits the 63 bytes of a Postgres identifier. The constructor checks the prefix before any statement is built and throws on any other value, so nothing unchecked reaches the SQL text. checkpointDdl makes the table for a prefix.