elph-core

Shared foundation for Elph applications. Provides filesystem helpers, default home-directory scaffold files (BundledManifest, TrustStore, VersionFile), structured logging, config/data path resolution utilities, and the floppy agent memory module.

Memory

Elph memory floppy is a Turso-backed agent memory store: semantic retrieval, per-memory weight scoring, and task-scoped lifecycle tracking. Memories persist across sessions so agents can reuse lessons from past work.

use elph_core::floppy::{FloppyBuilder, FastEmbedOptions};

let store = FloppyBuilder::new("/path/to/memory.db", "session-id")
    .fastembed(FastEmbedOptions::default())? // requires `fastembed`
    .build()?;

store.init().await?;
let result = store.start_task("implement auth middleware").await?;
// result.memories — top-k relevant memories for this task

Feature: fastembed — local embeddings via fastembed (all-MiniLM-L6-v2, 384 dims). Without it, supply your own EmbedFn.

Configuration: explicit via FloppyBuilder — floppy does not read environment variables. Paths: Elph stores project memory at PROJECT_DIR/.elph/memory.db. Standalone default: FloppyPaths::project_local() → ./.floppy/memory.db.

Full documentation: docs/memory.md.

Third-party attribution

The floppy module is ported from memelord (packages/sdk). The original code is licensed under the MIT License. Copyright (c) 2026 Glauber Costa.

License

Licensed under the MIT License.