Expand description
Agent memory store for task-scoped retrieval, scoring, and weight updates.
Ported from the memelord SDK
(packages/sdk). The original code is licensed under the
MIT License.
Copyright (c) 2026 Glauber Costa.
This Rust port preserves the core design (Turso-backed vector search, Welford baseline scoring, EMA weight updates) with platform-specific adaptations for the Turso Rust driver.
Configuration is explicit: use FloppyBuilder or FloppyConfig builder methods.
No environment variables are read inside this module.
Re-exports§
pub use migrations::FloppyMigration;pub use migrations::LAST_VERSION;pub use migrations::MIGRATIONS;pub use migrations::V1_NAME;pub use migrations::V1_UP;pub use migrations::V2_NAME;pub use migrations::V2_UP;pub use migrations::V3_NAME;pub use migrations::V3_UP;
Modules§
- migrations
- Versioned schema migrations for the floppy memory store.
Structs§
- Category
Count - Contradict
Result - Decay
Result - EndTask
With Decay Result - Fast
Embed Options - Options for the fastembed-backed local embedder.
- Floppy
Builder - Builder for a
MemoryStorewith explicit configuration (no environment variables). - Floppy
Config - Floppy
Paths - Resolved filesystem paths for a floppy store.
- Memory
- Memory
Record - Full memory row for inspection and listing APIs.
- Memory
Report Input - Memory
Stats - Memory
Store - Report
Correction Input - Report
User Input - Self
Report Entry - Start
Task Result - Store
Status - Extended store status (counts, categories, top memories, task metrics).
- Task
Baseline - Running baseline for z-score computation
- Task
Created Memory - Task
EndInput - Task
Record - Task summary (
tasksCLI command). - Task
Retrieval - Timeline
Event - TopMemory
Enums§
- Embedding
Status - Memory
Category - Memory
Report Type - Unified memory report input.
- Task
Status - Timeline
Event Kind - User
Input Source - Vector
Type - Turso vector type for distance calculations. Easy to swap for experimentation.
Constants§
- DB_
FILE_ NAME - Database file name inside the data directory.
- DEFAULT_
DATA_ DIR - Default data directory name for a standalone floppy store.
- DEFAULT_
EMBEDDING_ DIMS - Dimensions for the default all-MiniLM-L6-v2 model.
- DEFAULT_
EMBED_ MODEL - Default embedding model when none is configured.
- VALID_
EMBEDDING_ BYTES - Valid f32 embedding blob size for 384-dim vectors (Turso
vector32).
Functions§
- category_
str - create_
fastembed - create_
memory_ store - noop_
embedder - Embedder that returns zero vectors (read-only inspection without a model).