Skip to main content

Crate codewhale_state

Crate codewhale_state 

Source
Expand description

Persistent state management for conversation threads, messages, and jobs.

The StateStore is the primary entry point, backed by a SQLite database and an append-only JSONL session index file. It provides CRUD operations for:

  • Threads — conversation metadata, archival, and session indexing.
  • Messages — append-only message storage with tree-structured branching.
  • Checkpoints — named state snapshots for restoring conversation progress.
  • Jobs — background task tracking with status and progress.
  • Dynamic tools — per-thread tool registrations.

Structs§

CheckpointRecord
A named checkpoint capturing the state of a thread at a point in time.
DynamicToolRecord
A dynamically registered tool associated with a thread.
JobStateRecord
Persisted state of a background job.
MessageRecord
A single message entry in a conversation thread.
StateStore
Persistent storage for conversation threads, messages, checkpoints, and jobs.
ThreadListFilters
Filters for listing conversation threads.
ThreadMetadata
Metadata for a persisted conversation thread.

Enums§

JobStateStatus
Status of a background job.
SessionSource
Indicates how a session was initiated.
ThreadStatus
Lifecycle status of a conversation thread.