RECEIPTS PACK — STEP 5
Architecture Diagram Set
Three diagrams. Request path, async queue, security model.
Request Path — Happy Path
User/App → MemoryWell API → Storage/Index → Retrieval/Search
The synchronous path. Store writes to the bottle store, generates an embedding, and registers a catalog address. Recall and Search both go through the same API layer — auth, rate limit, audit — then hit the appropriate backend.
Your AI App
Client (any language)
POST any endpoint
MemoryWell API
Auth · Rate Limit · Audit
response
MemoryBottle
Canonical store
Embedding Index
Vector similarity
BottleCatalog
Tier + time address
mwRecallMemory
Direct ID fetch
mwSearchMemories
Vector → ranked results
mwListMemories
Tier/bucket filter
DATA FLOW
→ Store path: App → API → MemoryBottle → Embed → Catalog→ Search: API → vector index → ranked results→ List: API → BottleCatalog → metadata (no full content)