@memstack/core 0.7.0 → 0.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -10
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +19 -15
- package/dist/index.d.ts +19 -15
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +14 -5
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# MemStack
|
|
2
2
|
|
|
3
|
+
> Implementation priority is maintained in the [canonical roadmap](docs/ROADMAP.md).
|
|
4
|
+
|
|
3
5
|
> The open-source memory layer for AI agents — store, retrieve, summarize, and prune.
|
|
4
6
|
|
|
5
7
|
[](https://www.npmjs.com/package/@memstack/core)
|
|
@@ -673,9 +675,16 @@ new OpenAIEmbeddingAdapter({ apiKey: "...", baseURL: "https://api.voyageai.com/v
|
|
|
673
675
|
|
|
674
676
|
### Storage Adapters
|
|
675
677
|
|
|
676
|
-
MemStack
|
|
678
|
+
MemStack contains 18 storage-adapter implementations. Twelve are exported from `@memstack/core`; six remain experimental source implementations. Core has no runtime dependencies, and database clients are injected by callers.
|
|
679
|
+
|
|
680
|
+
**Support levels:**
|
|
677
681
|
|
|
678
|
-
|
|
682
|
+
- **Production-ready** means exported from the public package, covered by unit tests, and supported as part of the public API.
|
|
683
|
+
- **Real-service E2E verified** means the adapter also passes against its actual database implementation in `pnpm test:e2e`.
|
|
684
|
+
- **Mock-tested** means unit coverage uses an injected fake client rather than a live cloud service.
|
|
685
|
+
- **Experimental** means implemented in source but not exported from the published package.
|
|
686
|
+
|
|
687
|
+
### Public package exports
|
|
679
688
|
|
|
680
689
|
**Built-in (zero external deps):**
|
|
681
690
|
| Adapter | Backend | Use case |
|
|
@@ -709,9 +718,9 @@ MemStack ships with **12 production-ready storage adapters (6 experimental)**
|
|
|
709
718
|
|---|---|
|
|
710
719
|
| `Neo4jStorageAdapter` | Neo4j |
|
|
711
720
|
|
|
712
|
-
### Experimental (mock-tested
|
|
721
|
+
### Experimental (mock-tested or missing an optional E2E capability)
|
|
713
722
|
|
|
714
|
-
|
|
723
|
+
These implementations are available to source contributors but are not part of the published package API.
|
|
715
724
|
|
|
716
725
|
| Adapter | Backend | Blocker |
|
|
717
726
|
|---|---|---|
|
|
@@ -722,7 +731,7 @@ Available via direct source import. Not yet in the barrel export — uncomment i
|
|
|
722
731
|
| `Mem0StorageAdapter` | Mem0 OSS or Cloud | Cloud-only (needs API key) |
|
|
723
732
|
| `ZepStorageAdapter` | Zep Cloud or CE | Cloud-only (needs API key) |
|
|
724
733
|
|
|
725
|
-
|
|
734
|
+
Live cloud compatibility remains unverified for Pinecone, Upstash, Mem0, Zep, and Turso. Chroma's real-client E2E suite is skipped when its optional default embedding function is unavailable. LLM and embedding-provider tests use mocks; live-provider testing is opt-in and is not part of CI.
|
|
726
735
|
|
|
727
736
|
**Quick-start per backend:**
|
|
728
737
|
|
|
@@ -965,13 +974,21 @@ git clone https://github.com/isiomaC/memstack.git
|
|
|
965
974
|
cd memstack
|
|
966
975
|
pnpm install
|
|
967
976
|
|
|
968
|
-
pnpm test
|
|
969
|
-
pnpm test:
|
|
970
|
-
pnpm test:
|
|
971
|
-
pnpm
|
|
972
|
-
pnpm
|
|
977
|
+
pnpm test # 407 core tests, no external services needed
|
|
978
|
+
pnpm test:packages # 78 package tests after dependency-ordered builds
|
|
979
|
+
pnpm test:e2e # 80 pass, 1 optional Chroma skip (requires Docker services)
|
|
980
|
+
pnpm test:e2e:run # Start services, run E2E once, preserve failure logs, clean up
|
|
981
|
+
pnpm smoke:artifacts # Built core, CLI, MCP, and server black-box checks
|
|
982
|
+
pnpm smoke:packages # Pack and install publishable tarballs in a clean project
|
|
983
|
+
pnpm smoke:docker # Build and exercise the server image
|
|
984
|
+
pnpm verify # Complete local verification pipeline
|
|
985
|
+
pnpm test:watch # Watch core tests
|
|
986
|
+
pnpm build:all # Build core and all workspace packages
|
|
987
|
+
pnpm check:all # Type-check core and all workspace packages
|
|
973
988
|
```
|
|
974
989
|
|
|
990
|
+
CI exposes a stable `verification` job. Configure that job as a required status check in GitHub branch protection for `main`.
|
|
991
|
+
|
|
975
992
|
### Debugging
|
|
976
993
|
|
|
977
994
|
Use hooks for observability — MemStack has no built-in logging:
|
package/dist/index.cjs
CHANGED
|
@@ -3221,7 +3221,7 @@ var LanceDBStorageAdapter = class {
|
|
|
3221
3221
|
return results;
|
|
3222
3222
|
}
|
|
3223
3223
|
async get(id) {
|
|
3224
|
-
const results = await this.table.search(this._zeroVector).limit(1).where(`id = "${id}"`).execute();
|
|
3224
|
+
const results = await this.table.search(this._zeroVector).limit(1).where(`id = "${id}"`).prefilter(true).execute();
|
|
3225
3225
|
if (results.length === 0) return null;
|
|
3226
3226
|
const row = results[0];
|
|
3227
3227
|
if (row.expires_at) {
|