mnemocyte 0.0.6 → 0.0.8

package/README.md

@@ -65,6 +65,68 @@ embedder,
 
 The published package includes `migrations/0000_initial.sql`.
 
+## Provider resilience
+
+Mnemocyte applies an optional timeout and retry policy to every outbound
+embedder call, and forwards `AbortSignal` cancellation to in-flight
+attempts. Defaults disable both retries and timeouts so existing setups
+are unaffected.
+
+```ts
+const client = createMnemocyte({
+embedder,
+provider: {
+timeoutMs: 5_000,
+retries: 2,
+baseDelayMs: 200,
+maxDelayMs: 2_000,
+},
+});
+
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 1_000);
+
+await client.remember({
+entityId: "user_123",
+content: "Prefers short answers.",
+signal: controller.signal,
+});
+```
+
+Failures surface as `MnemocyteError` with stable `code`s:
+
+- `"TIMEOUT"` — a single provider attempt exceeded `timeoutMs`.
+- `"ABORTED"` — the operation was cancelled via `signal` (never retried).
+- `"EMBEDDING"` — the embedder failed after all retries are exhausted.
+
+## Pruning memories
+
+`prune` bulk-deletes memories matching a filter. At least one selector
+is required; `prune({})` is rejected to avoid accidental full deletion.
+
+```ts
+// Drop expired memories for one entity.
+await client.prune({ entityId: "user_123", expired: true });
+
+// Evict memories not accessed in the last 30 days, but never drop
+// "high" or "critical" memories.
+await client.prune({
+notAccessedSince: new Date(Date.now() - 30 * 24 * 3600 * 1000),
+maxImportance: "normal",
+});
+
+// Count what would be deleted without touching the store.
+const preview = await client.prune({
+entityId: "user_123",
+superseded: true,
+dryRun: true,
+});
+console.log(preview.matchedCount);
+```
+
+Available selectors: `entityId`, `expired`, `superseded`, `createdBefore`,
+`notAccessedSince`, `types`, `tags`, `maxImportance`. They AND together.
+
 ## Retrieval tuning
 
 ```ts
@@ -93,7 +155,7 @@ pnpm checktypes
 pnpm lint
 pnpm run test:retrieval
 pnpm run test:integration
-pnpm pack --dry-run
+pnpm run pack:check
 ```
 
 `test:integration` skips cleanly when `DATABASE_URL` is not set.