mnemocyte 0.3.0 → 0.4.0

package/dist/{types-gOPLre4V.d.mts → types-DH0inEay.d.mts}

@@ -111,17 +111,25 @@ interface ProviderResilienceConfig {
   /**
    * Maximum time, in milliseconds, that a single provider attempt may
    * run before a {@link MnemocyteError} with code `"TIMEOUT"` is thrown.
-   * Defaults to `0` which disables the timeout.
+   * Must be a non-negative finite number. Defaults to `0` which disables the
+   * timeout.
    */
   timeoutMs?: number;
   /**
-   * Maximum number of retry attempts after the initial call. `0`
-   * disables retries (default).
+   * Maximum number of retry attempts after the initial call. Must be a
+   * non-negative integer. `0` disables retries (default).
    */
   retries?: number;
-  /** Base backoff delay (ms) used before the first retry. Defaults to `100`. */
+  /**
+   * Base backoff delay (ms) used before the first retry. Must be a
+   * non-negative finite number. Defaults to `100`.
+   */
   baseDelayMs?: number;
-  /** Maximum backoff delay (ms) used between retries. Defaults to `2000`. */
+  /**
+   * Maximum backoff delay (ms) used between retries. Must be a non-negative
+   * finite number. Values below `baseDelayMs` are normalized up to the base
+   * delay. Defaults to `2000`.
+   */
   maxDelayMs?: number;
   /**
    * Optional predicate deciding whether `error` should trigger a retry.
@@ -140,7 +148,9 @@ interface MnemocyteConfig {
   /**
    * Postgres connection string. When set, the client uses the Postgres
    * backend (requires the `pgvector` extension and a rendered migration
-   * with `mnemocyte_meta.embedding_dimensions` matching the embedder).
+   * with `mnemocyte_meta.embedding_dimensions` matching the embedder and
+   * `embedding_model` metadata available). Must use the `postgres:` or
+   * `postgresql:` protocol.
    * When omitted, an in-memory backend is used.
    */
   databaseUrl?: string;
@@ -191,8 +201,9 @@ interface AuditConfig {
  * (e.g. OpenAI, Cohere, a local model) in a small interface.
  *
  * Mnemocyte records {@link Embedder.model} and {@link Embedder.dimensions}
- * on every stored memory and uses them to detect incompatible vectors
- * (e.g. when the model is swapped).
+ * on every stored memory. The Postgres backend also records both values as
+ * installation metadata and rejects embedding-dependent operations when the
+ * configured embedder is incompatible.
  */
 interface Embedder {
   /** Stable identifier for the underlying model (e.g. `"text-embedding-3-small"`). */
@@ -484,7 +495,10 @@ interface BuildContextInput {
  * Input for {@link MnemocyteClient.prune}. All fields are optional, but
  * at least one selector must be set; calling `prune({})` is rejected with
  * a `"VALIDATION"` {@link MnemocyteError} so memories cannot be deleted
- * accidentally. Specified filters are combined with AND semantics.
+ * accidentally. Runtime values are validated before storage access; malformed
+ * dates, enums, arrays, booleans, and signals are rejected. `false` selector
+ * flags and empty selector arrays do not count as effective selectors after
+ * normalization. Specified filters are combined with AND semantics.
  */
 interface PruneInput {
   /** Restrict pruning to a single entity. */
@@ -518,7 +532,11 @@ interface PruneInput {
    * @defaultValue `false`
    */
   dryRun?: boolean;
-  /** Optional cancellation signal. */
+  /**
+   * Optional cancellation signal. A pre-aborted signal prevents storage work.
+   * In-flight Postgres pruning requests server-query cancellation, but a
+   * deletion that has already committed cannot be undone.
+   */
   signal?: AbortSignal;
 }
 /**
@@ -566,7 +584,10 @@ interface FindDuplicatesInput {
   includeSuperseded?: boolean;
   /** Include expired memories in the scan. @defaultValue `false` */
   includeExpired?: boolean;
-  /** Optional cancellation signal. */
+  /**
+   * Optional cancellation signal. In-memory scans check it cooperatively;
+   * Postgres requests cancellation of the active duplicate-search query.
+   */
   signal?: AbortSignal;
 }
 /**
@@ -606,6 +627,17 @@ interface AuditEvent {
   /** When the change was recorded. */
   timestamp: Date;
 }
+/**
+ * Stable composite position for deterministic audit-log pagination.
+ *
+ * @experimental Part of Phase 6 (consolidation tooling). Shape may change.
+ */
+interface AuditLogCursor {
+  /** Event timestamp at the page boundary. */
+  timestamp: Date;
+  /** Event ID used to break timestamp ties. */
+  id: string;
+}
 /**
  * Input for {@link MnemocyteClient.listAuditLog}.
  *
@@ -619,11 +651,32 @@ interface ListAuditLogInput {
    * @defaultValue `50`
    */
   limit?: number;
-  /** Only return entries strictly before this timestamp. */
+  /**
+   * Only return entries strictly before this timestamp. This is a filter, not
+   * a complete pagination cursor: events sharing the timestamp are excluded.
+   */
   before?: Date;
-  /** Only return entries strictly after this timestamp. */
+  /**
+   * Only return entries strictly after this timestamp. This is a filter, not
+   * a complete pagination cursor: events sharing the timestamp are excluded.
+   */
   after?: Date;
-  /** Optional cancellation signal. */
+  /**
+   * Return entries strictly older than this stable `(timestamp, id)` position.
+   *
+   * @experimental Prefer this over `before` for complete pagination.
+   */
+  beforeCursor?: AuditLogCursor;
+  /**
+   * Return entries strictly newer than this stable `(timestamp, id)` position.
+   *
+   * @experimental Prefer this over `after` for complete pagination.
+   */
+  afterCursor?: AuditLogCursor;
+  /**
+   * Optional cancellation signal. In-memory scans check it cooperatively;
+   * Postgres requests cancellation of the active audit-log query.
+   */
   signal?: AbortSignal;
 }
 /**
@@ -641,9 +694,10 @@ interface ConsolidateInput {
   /** Memory that should win the merge. Must not itself be superseded. */
   survivorId: string;
   /**
-   * Memories to mark as superseded by the survivor. Already-superseded
-   * entries in this list are skipped silently for idempotency. Must
-   * not contain {@link ConsolidateInput.survivorId}.
+   * Memories to mark as superseded by the survivor. Entries already
+   * superseded by this same survivor are skipped for idempotency. If any
+   * entry points to a different survivor, the entire call rejects with
+   * `"CONFLICT"`. Must not contain {@link ConsolidateInput.survivorId}.
    */
   supersededIds: readonly string[];
   /**
@@ -652,7 +706,13 @@ interface ConsolidateInput {
    * @defaultValue `true`
    */
   mergeTags?: boolean;
-  /** Optional cancellation signal. */
+  /**
+   * Optional cancellation signal. Postgres checks it between transaction
+   * steps and immediately before the transaction callback returns. A
+   * statement already in flight may finish before the next check rolls the
+   * transaction back. An abort after the final check, including while commit
+   * is in flight, may still leave the consolidation committed.
+   */
   signal?: AbortSignal;
 }
 /**
@@ -665,7 +725,7 @@ interface ConsolidateResult {
   survivorId: string;
   /**
    * Number of memories actually marked as superseded. Excludes entries
-   * that were already superseded (idempotent skip).
+   * that already pointed to this survivor (idempotent skip).
    */
   supersededCount: number;
   /** The IDs that were newly superseded during this call. */
@@ -744,12 +804,20 @@ interface MnemocyteClient {
    *
    * @throws {MnemocyteError} `"NOT_FOUND"` if the memory does not exist
    * or does not belong to `entityId`.
+   * @throws {MnemocyteError} `"CONFLICT"` if another memory still
+   * references this memory as its consolidation survivor.
    */
   forget(input: {
     entityId: string;
     memoryId: string;
   }): Promise<void>;
-  /** Delete every memory belonging to `entityId`. */
+  /**
+   * Delete every memory belonging to `entityId`.
+   *
+   * @throws {MnemocyteError} `"CONFLICT"` if any selected memory is still
+   * referenced as a consolidation survivor, including by another selected
+   * memory.
+   */
   forgetAll(input: {
     entityId: string;
   }): Promise<void>;
@@ -760,6 +828,10 @@ interface MnemocyteClient {
    * `"VALIDATION"` {@link MnemocyteError} to avoid accidental full
    * deletion. Pass `dryRun: true` to count without deleting.
    *
+   * @throws {MnemocyteError} `"CONFLICT"` when a non-dry-run prune selects
+   * a memory that still has consolidation dependents. The prune deletes
+   * nothing in that case.
+   *
    * @example Evict expired or stale memories for an entity
    * ```ts
    * await client.prune({
@@ -832,7 +904,10 @@ interface MnemocyteClient {
   }): Promise<EntityStats | GlobalStats>;
   /**
    * Release any underlying resources (e.g. the Postgres connection pool).
-   * Safe to call multiple times. The client must not be used afterward.
+   * New operations are rejected once closing starts. The returned promise
+   * waits for operations that already started, then closes the store. Safe to
+   * call multiple times; concurrent calls share the same close operation.
+   * If closing the store fails, the client reopens so callers may retry.
    */
   close(): Promise<void>;
 }
@@ -846,11 +921,13 @@ interface ExperimentalMnemocyteClient {
   /**
    * Consolidate likely-duplicate memories into a single survivor by
    * marking the others as superseded. Optionally unions their tags
-   * onto the survivor. Idempotent for memories that are already
-   * superseded.
+   * onto the survivor. Idempotent when every already-superseded loser
+   * points to the requested survivor.
    *
    * Emits one `"memory.superseded"` audit event per newly superseded
    * memory when {@link MnemocyteConfig.audit}.`enabled` is `true`.
+   * A survivor cannot later be deleted while any superseded memory still
+   * references it; deletion attempts fail with `"CONFLICT"`.
    *
    * @experimental Part of Phase 6 (consolidation tooling). API may change.
    *
@@ -858,8 +935,11 @@ interface ExperimentalMnemocyteClient {
    * a `survivorId` that also appears in `supersededIds`, or a survivor
    * that is itself already superseded.
    * @throws {MnemocyteError} `"NOT_FOUND"` if the survivor or any
-   * non-already-superseded memory in `supersededIds` does not belong
-   * to `entityId`.
+   * memory in `supersededIds` does not belong to `entityId`.
+   * @throws {MnemocyteError} `"CONFLICT"` if any memory in
+   * `supersededIds` already points to a different survivor. The whole
+   * call is rejected before any loser, survivor tags, or audit events
+   * are changed.
    *
    * @example
    * ```ts
@@ -876,5 +956,5 @@ interface ExperimentalMnemocyteClient {
   consolidate(input: ConsolidateInput): Promise<ConsolidateResult>;
 }
 //#endregion
-export { RecallInput as A, MnemocyteObservation as C, ProviderResilienceConfig as D, ObservabilityConfig as E, RetrievalScoreWeights as F, RetrievalScores as I, TokenCounter as L, RememberManyInput as M, RetrievalConfig as N, PruneInput as O, RetrievalExplanation as P, MnemocyteConfig as S, MnemocyteOperation as T, Memory as _, ConsolidateResult as a, MnemocyteBackend as b, Embedder as c, FindDuplicatesInput as d, GlobalStats as f, ListAuditLogInput as g, JsonValue as h, ConsolidateInput as i, RememberInput as j, PruneResult as k, EntityStats as l, JsonObject as m, AuditEvent as n, ContextFormat as o, ImportanceLevel as p, BuildContextInput as r, DuplicatePair as s, AuditConfig as t, ExperimentalMnemocyteClient as u, MemoryType as v, MnemocyteObservationPhase as w, MnemocyteClient as x, MemoryWithScore as y };
-//# sourceMappingURL=types-gOPLre4V.d.mts.map
+export { PruneResult as A, MnemocyteConfig as C, ObservabilityConfig as D, MnemocyteOperation as E, RetrievalExplanation as F, RetrievalScoreWeights as I, RetrievalScores as L, RememberInput as M, RememberManyInput as N, ProviderResilienceConfig as O, RetrievalConfig as P, TokenCounter as R, MnemocyteClient as S, MnemocyteObservationPhase as T, ListAuditLogInput as _, ConsolidateInput as a, MemoryWithScore as b, DuplicatePair as c, ExperimentalMnemocyteClient as d, FindDuplicatesInput as f, JsonValue as g, JsonObject as h, BuildContextInput as i, RecallInput as j, PruneInput as k, Embedder as l, ImportanceLevel as m, AuditEvent as n, ConsolidateResult as o, GlobalStats as p, AuditLogCursor as r, ContextFormat as s, AuditConfig as t, EntityStats as u, Memory as v, MnemocyteObservation as w, MnemocyteBackend as x, MemoryType as y };
+//# sourceMappingURL=types-DH0inEay.d.mts.map

package/dist/types-DH0inEay.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DH0inEay.d.mts","names":[],"sources":["../src/types.ts"],"mappings":"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"}

package/migrations/0000_initial.sql.template

@@ -8,7 +8,8 @@ CREATE TABLE "mnemocyte_events" (
 --> statement-breakpoint
 CREATE TABLE "mnemocyte_meta" (
 	"key" text PRIMARY KEY NOT NULL,
-	"embedding_dimensions" integer NOT NULL
+	"embedding_dimensions" integer NOT NULL,
+	"embedding_model" text
 );
 --> statement-breakpoint
 INSERT INTO "mnemocyte_meta" ("key", "embedding_dimensions") VALUES ('installation', {{EMBEDDING_DIMENSIONS}});

package/migrations/0002_add_embedding_model.sql

@@ -0,0 +1,15 @@
+ALTER TABLE "mnemocyte_meta" ADD COLUMN "embedding_model" text;
+--> statement-breakpoint
+UPDATE "mnemocyte_meta"
+SET "embedding_model" = (
+	SELECT min("embedding_model")
+	FROM "mnemocyte_memories"
+	HAVING count(DISTINCT "embedding_model") = 1
+)
+WHERE
+	"key" = 'installation'
+	AND "embedding_model" IS NULL
+	AND (
+		SELECT count(DISTINCT "embedding_model")
+		FROM "mnemocyte_memories"
+	) = 1;

package/migrations/meta/0002_snapshot.json

@@ -0,0 +1,315 @@
+{
+	"id": "b7cab9b6-6cbf-40c0-8796-50150531a577",
+	"prevId": "59920203-e7f9-4cdd-9580-1c7b42ac242e",
+	"version": "7",
+	"dialect": "postgresql",
+	"tables": {
+		"public.mnemocyte_events": {
+			"name": "mnemocyte_events",
+			"schema": "",
+			"columns": {
+				"id": {
+					"name": "id",
+					"type": "text",
+					"primaryKey": true,
+					"notNull": true
+				},
+				"entity_id": {
+					"name": "entity_id",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"description": {
+					"name": "description",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"metadata": {
+					"name": "metadata",
+					"type": "jsonb",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "'{}'::jsonb"
+				},
+				"timestamp": {
+					"name": "timestamp",
+					"type": "timestamp with time zone",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "now()"
+				}
+			},
+			"indexes": {
+				"mnemocyte_events_entity_time_idx": {
+					"name": "mnemocyte_events_entity_time_idx",
+					"columns": [
+						{
+							"expression": "entity_id",
+							"isExpression": false,
+							"asc": true,
+							"nulls": "last"
+						},
+						{
+							"expression": "timestamp",
+							"isExpression": false,
+							"asc": true,
+							"nulls": "last"
+						}
+					],
+					"isUnique": false,
+					"concurrently": false,
+					"method": "btree",
+					"with": {}
+				}
+			},
+			"foreignKeys": {},
+			"compositePrimaryKeys": {},
+			"uniqueConstraints": {},
+			"policies": {},
+			"checkConstraints": {},
+			"isRLSEnabled": false
+		},
+		"public.mnemocyte_memories": {
+			"name": "mnemocyte_memories",
+			"schema": "",
+			"columns": {
+				"id": {
+					"name": "id",
+					"type": "text",
+					"primaryKey": true,
+					"notNull": true
+				},
+				"entity_id": {
+					"name": "entity_id",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"content": {
+					"name": "content",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"type": {
+					"name": "type",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "'fact'"
+				},
+				"importance": {
+					"name": "importance",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "'normal'"
+				},
+				"tags": {
+					"name": "tags",
+					"type": "text[]",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "'{}'::text[]"
+				},
+				"source": {
+					"name": "source",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": false
+				},
+				"metadata": {
+					"name": "metadata",
+					"type": "jsonb",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "'{}'::jsonb"
+				},
+				"confidence": {
+					"name": "confidence",
+					"type": "real",
+					"primaryKey": false,
+					"notNull": true,
+					"default": 1
+				},
+				"embedding": {
+					"name": "embedding",
+					"type": "vector(1536)",
+					"primaryKey": false,
+					"notNull": false
+				},
+				"embedding_model": {
+					"name": "embedding_model",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"embedding_dimensions": {
+					"name": "embedding_dimensions",
+					"type": "integer",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"superseded_by": {
+					"name": "superseded_by",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": false
+				},
+				"superseded_at": {
+					"name": "superseded_at",
+					"type": "timestamp with time zone",
+					"primaryKey": false,
+					"notNull": false
+				},
+				"expires_at": {
+					"name": "expires_at",
+					"type": "timestamp with time zone",
+					"primaryKey": false,
+					"notNull": false
+				},
+				"last_accessed_at": {
+					"name": "last_accessed_at",
+					"type": "timestamp with time zone",
+					"primaryKey": false,
+					"notNull": false
+				},
+				"access_count": {
+					"name": "access_count",
+					"type": "integer",
+					"primaryKey": false,
+					"notNull": true,
+					"default": 0
+				},
+				"created_at": {
+					"name": "created_at",
+					"type": "timestamp with time zone",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "now()"
+				},
+				"updated_at": {
+					"name": "updated_at",
+					"type": "timestamp with time zone",
+					"primaryKey": false,
+					"notNull": true,
+					"default": "now()"
+				}
+			},
+			"indexes": {
+				"mnemocyte_memories_entity_idx": {
+					"name": "mnemocyte_memories_entity_idx",
+					"columns": [
+						{
+							"expression": "entity_id",
+							"isExpression": false,
+							"asc": true,
+							"nulls": "last"
+						}
+					],
+					"isUnique": false,
+					"concurrently": false,
+					"method": "btree",
+					"with": {}
+				},
+				"mnemocyte_memories_entity_type_idx": {
+					"name": "mnemocyte_memories_entity_type_idx",
+					"columns": [
+						{
+							"expression": "entity_id",
+							"isExpression": false,
+							"asc": true,
+							"nulls": "last"
+						},
+						{
+							"expression": "type",
+							"isExpression": false,
+							"asc": true,
+							"nulls": "last"
+						}
+					],
+					"isUnique": false,
+					"concurrently": false,
+					"method": "btree",
+					"with": {}
+				},
+				"mnemocyte_memories_embedding_hnsw_idx": {
+					"name": "mnemocyte_memories_embedding_hnsw_idx",
+					"columns": [
+						{
+							"expression": "embedding",
+							"isExpression": false,
+							"asc": true,
+							"nulls": "last",
+							"opclass": "vector_cosine_ops"
+						}
+					],
+					"isUnique": false,
+					"concurrently": false,
+					"method": "hnsw",
+					"with": {}
+				}
+			},
+			"foreignKeys": {
+				"mnemocyte_memories_superseded_by_mnemocyte_memories_id_fk": {
+					"name": "mnemocyte_memories_superseded_by_mnemocyte_memories_id_fk",
+					"tableFrom": "mnemocyte_memories",
+					"tableTo": "mnemocyte_memories",
+					"columnsFrom": ["superseded_by"],
+					"columnsTo": ["id"],
+					"onDelete": "no action",
+					"onUpdate": "no action"
+				}
+			},
+			"compositePrimaryKeys": {},
+			"uniqueConstraints": {},
+			"policies": {},
+			"checkConstraints": {},
+			"isRLSEnabled": false
+		},
+		"public.mnemocyte_meta": {
+			"name": "mnemocyte_meta",
+			"schema": "",
+			"columns": {
+				"key": {
+					"name": "key",
+					"type": "text",
+					"primaryKey": true,
+					"notNull": true
+				},
+				"embedding_dimensions": {
+					"name": "embedding_dimensions",
+					"type": "integer",
+					"primaryKey": false,
+					"notNull": true
+				},
+				"embedding_model": {
+					"name": "embedding_model",
+					"type": "text",
+					"primaryKey": false,
+					"notNull": false
+				}
+			},
+			"indexes": {},
+			"foreignKeys": {},
+			"compositePrimaryKeys": {},
+			"uniqueConstraints": {},
+			"policies": {},
+			"checkConstraints": {},
+			"isRLSEnabled": false
+		}
+	},
+	"enums": {},
+	"schemas": {},
+	"sequences": {},
+	"roles": {},
+	"policies": {},
+	"views": {},
+	"_meta": {
+		"columns": {},
+		"schemas": {},
+		"tables": {}
+	}
+}

package/migrations/meta/_journal.json

@@ -15,6 +15,13 @@
 			"when": 1779455085280,
 			"tag": "0001_add_mnemocyte_meta",
 			"breakpoints": true
+		},
+		{
+			"idx": 2,
+			"version": "7",
+			"when": 1784201870906,
+			"tag": "0002_add_embedding_model",
+			"breakpoints": true
 		}
 	]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mnemocyte",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Persistent memory for TypeScript AI apps.",
   "type": "module",
   "sideEffects": false,

package/dist/types-gOPLre4V.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-gOPLre4V.d.mts","names":[],"sources":["../src/types.ts"],"mappings":"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"}