swarm-mail 0.4.0 → 0.5.0

package/README.md

@@ -47,6 +47,9 @@ Event sourcing primitives for multi-agent coordination. Local-first, no external
 │  ├── DurableCursor - Checkpointed stream reader            │
 │  └── DurableDeferred - Distributed promise                 │
 │                                                             │
+│  MEMORY                                                     │
+│  └── Semantic Memory - Vector embeddings (pgvector/Ollama) │
+│                                                             │
 │  STORAGE                                                    │
 │  └── PGLite (Embedded Postgres) + Migrations               │
 └─────────────────────────────────────────────────────────────┘
@@ -183,12 +186,46 @@ Materialized views derived from events:
 | `swarm_contexts`    | Checkpoint state for recovery      |
 | `eval_records`      | Outcome data for learning          |
 
+### Semantic Memory
+
+Persistent, searchable storage for agent learnings:
+
+```typescript
+import { createMemoryAdapter } from 'swarm-mail/memory'
+
+const swarmMail = await getSwarmMail('/my/project')
+const db = await swarmMail.getDatabase()
+const memory = await createMemoryAdapter(db)
+
+// Store a learning
+const { id } = await memory.store(
+  "OAuth refresh tokens need 5min buffer before expiry...",
+  { tags: "auth,tokens,debugging" }
+)
+
+// Search by meaning (vector similarity)
+const results = await memory.find("token refresh issues")
+
+// Check Ollama health
+const health = await memory.checkHealth()
+// { ollama: true, model: "mxbai-embed-large" }
+```
+
+> **Note:** Requires [Ollama](https://ollama.ai/) for vector embeddings. Falls back to full-text search if unavailable.
+>
+> ```bash
+> ollama pull mxbai-embed-large
+> ```
+
+> **Deprecation Notice:** The standalone [semantic-memory MCP server](https://github.com/joelhooks/semantic-memory) is deprecated. Use the embedded memory in swarm-mail instead - same API, single PGLite instance, no separate process.
+
 ## Architecture
 
 - **Append-only log** - Events are immutable, projections are derived
 - **Local-first** - PGLite embedded Postgres, no external servers
 - **Effect-TS** - Type-safe, composable, testable
 - **Exactly-once** - DurableCursor checkpoints position
+- **Semantic memory** - Vector embeddings with pgvector + Ollama
 
 ## API Reference
 

package/dist/index.d.ts

@@ -24,4 +24,11 @@ export * from "./streams";
 export * from "./hive";
 export { startDaemon, stopDaemon, isDaemonRunning, healthCheck, getPidFilePath, } from "./daemon";
 export type { DaemonOptions, DaemonInfo } from "./daemon";
+export { createMemoryStore, EMBEDDING_DIM, } from "./memory/store";
+export type { Memory, SearchResult, SearchOptions, } from "./memory/store";
+export { Ollama, OllamaError, getDefaultConfig, makeOllamaLive, } from "./memory/ollama";
+export type { MemoryConfig } from "./memory/ollama";
+export { memoryMigration, memoryMigrations, } from "./memory/migrations";
+export { legacyDatabaseExists, migrateLegacyMemories, getMigrationStatus, getDefaultLegacyPath, } from "./memory/migrate-legacy";
+export type { MigrationOptions, MigrationResult, } from "./memory/migrate-legacy";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAM1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,MAAM,GACP,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAM7D,cAAc,WAAW,CAAC;AAM1B,cAAc,QAAQ,CAAC;AAMvB,OAAO,EACL,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAM1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,MAAM,GACP,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAM7D,cAAc,WAAW,CAAC;AAM1B,cAAc,QAAQ,CAAC;AAMvB,OAAO,EACL,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM1D,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,MAAM,EACN,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,yBAAyB,CAAC"}