mnemocyte 0.1.5 → 0.2.0

package/dist/{types-QK_43oKJ.d.mts → types-DXEGcc47.d.mts}

@@ -128,7 +128,8 @@ interface ProviderResilienceConfig {
 interface MnemocyteConfig {
   /**
    * Postgres connection string. When set, the client uses the Postgres
-   * backend (requires the `pgvector` extension and the bundled migration).
+   * backend (requires the `pgvector` extension and a rendered migration
+   * with `mnemocyte_meta.embedding_dimensions` matching the embedder).
    * When omitted, an in-memory backend is used.
    */
   databaseUrl?: string;
@@ -842,4 +843,4 @@ interface ExperimentalMnemocyteClient {
 }
 //#endregion
 export { RetrievalConfig as A, MnemocyteOperation as C, PruneResult as D, PruneInput as E, RetrievalScoreWeights as M, RetrievalScores as N, RecallInput as O, TokenCounter as P, MnemocyteObservationPhase as S, ProviderResilienceConfig as T, MemoryWithScore as _, ConsolidateResult as a, MnemocyteConfig as b, Embedder as c, FindDuplicatesInput as d, GlobalStats as f, MemoryType as g, Memory as h, ConsolidateInput as i, RetrievalExplanation as j, RememberInput as k, EntityStats as l, ListAuditLogInput as m, AuditEvent as n, ContextFormat as o, ImportanceLevel as p, BuildContextInput as r, DuplicatePair as s, AuditConfig as t, ExperimentalMnemocyteClient as u, MnemocyteBackend as v, ObservabilityConfig as w, MnemocyteObservation as x, MnemocyteClient as y };
-//# sourceMappingURL=types-QK_43oKJ.d.mts.map
+//# sourceMappingURL=types-DXEGcc47.d.mts.map

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

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

package/migrations/0000_initial.sql.template

@@ -0,0 +1,42 @@
+CREATE TABLE "mnemocyte_events" (
+	"id" text PRIMARY KEY NOT NULL,
+	"entity_id" text NOT NULL,
+	"description" text NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"timestamp" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "mnemocyte_meta" (
+	"key" text PRIMARY KEY NOT NULL,
+	"embedding_dimensions" integer NOT NULL
+);
+--> statement-breakpoint
+INSERT INTO "mnemocyte_meta" ("key", "embedding_dimensions") VALUES ('installation', {{EMBEDDING_DIMENSIONS}});
+--> statement-breakpoint
+CREATE TABLE "mnemocyte_memories" (
+	"id" text PRIMARY KEY NOT NULL,
+	"entity_id" text NOT NULL,
+	"content" text NOT NULL,
+	"type" text DEFAULT 'fact' NOT NULL,
+	"importance" text DEFAULT 'normal' NOT NULL,
+	"tags" text[] DEFAULT '{}'::text[] NOT NULL,
+	"source" text,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"confidence" real DEFAULT 1 NOT NULL,
+	"embedding" vector({{EMBEDDING_DIMENSIONS}}),
+	"embedding_model" text NOT NULL,
+	"embedding_dimensions" integer NOT NULL,
+	"superseded_by" text,
+	"superseded_at" timestamp with time zone,
+	"expires_at" timestamp with time zone,
+	"last_accessed_at" timestamp with time zone,
+	"access_count" integer DEFAULT 0 NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "mnemocyte_memories" ADD CONSTRAINT "mnemocyte_memories_superseded_by_mnemocyte_memories_id_fk" FOREIGN KEY ("superseded_by") REFERENCES "public"."mnemocyte_memories"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "mnemocyte_events_entity_time_idx" ON "mnemocyte_events" USING btree ("entity_id","timestamp");--> statement-breakpoint
+CREATE INDEX "mnemocyte_memories_entity_idx" ON "mnemocyte_memories" USING btree ("entity_id");--> statement-breakpoint
+CREATE INDEX "mnemocyte_memories_entity_type_idx" ON "mnemocyte_memories" USING btree ("entity_id","type");--> statement-breakpoint
+CREATE INDEX "mnemocyte_memories_embedding_hnsw_idx" ON "mnemocyte_memories" USING hnsw ("embedding" vector_cosine_ops);

package/migrations/0001_add_mnemocyte_meta.sql

@@ -0,0 +1,6 @@
+CREATE TABLE "mnemocyte_meta" (
+	"key" text PRIMARY KEY NOT NULL,
+	"embedding_dimensions" integer NOT NULL
+);
+--> statement-breakpoint
+INSERT INTO "mnemocyte_meta" ("key", "embedding_dimensions") VALUES ('installation', 1536);

package/migrations/meta/0001_snapshot.json

@@ -0,0 +1,309 @@
+{
+	"id": "59920203-e7f9-4cdd-9580-1c7b42ac242e",
+	"prevId": "feeb327d-c000-40d3-9c3c-3eb82b2e2e81",
+	"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
+				}
+			},
+			"indexes": {},
+			"foreignKeys": {},
+			"compositePrimaryKeys": {},
+			"uniqueConstraints": {},
+			"policies": {},
+			"checkConstraints": {},
+			"isRLSEnabled": false
+		}
+	},
+	"enums": {},
+	"schemas": {},
+	"sequences": {},
+	"roles": {},
+	"policies": {},
+	"views": {},
+	"_meta": {
+		"columns": {},
+		"schemas": {},
+		"tables": {}
+	}
+}

package/migrations/meta/_journal.json

@@ -8,6 +8,13 @@
 			"when": 1779280110397,
 			"tag": "0000_initial",
 			"breakpoints": true
+		},
+		{
+			"idx": 1,
+			"version": "7",
+			"when": 1779455085280,
+			"tag": "0001_add_mnemocyte_meta",
+			"breakpoints": true
 		}
 	]
 }

package/migrations/render-initial.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+function readOption(name) {
+	const index = process.argv.indexOf(name);
+	if (index === -1) return undefined;
+	return process.argv[index + 1];
+}
+
+function parseDimensions(value) {
+	const dimensions = Number(value);
+	if (!Number.isInteger(dimensions) || dimensions < 1) {
+		throw new Error("--dimensions must be a positive integer.");
+	}
+	return dimensions;
+}
+
+const dimensions = parseDimensions(readOption("--dimensions"));
+const out = readOption("--out");
+const dir = dirname(fileURLToPath(import.meta.url));
+const template = await readFile(
+	resolve(dir, "0000_initial.sql.template"),
+	"utf8",
+);
+const rendered = template.replaceAll(
+	"{{EMBEDDING_DIMENSIONS}}",
+	String(dimensions),
+);
+
+if (out) {
+	await writeFile(resolve(process.cwd(), out), rendered);
+} else {
+	process.stdout.write(rendered);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mnemocyte",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Persistent memory for TypeScript AI apps.",
   "type": "module",
   "sideEffects": false,
@@ -84,6 +84,7 @@
     "bench:retrieval": "vitest bench --project unit test/benchmarks/retrieval.bench.ts",
     "lint": "biome lint --write",
     "format": "biome format --write",
+    "migration:render": "node migrations/render-initial.mjs",
     "db:generate": "drizzle-kit generate",
     "db:migrate": "drizzle-kit migrate",
     "pack:check": "pnpm pack --dry-run"

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

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