heady-vector-memory 3.2.0

package/README.md

@@ -0,0 +1,42 @@
+# @heady/vector-memory
+
+> 3D vector memory store with cosine-similarity search for the Heady™ AI Platform.
+
+## Install
+
+```bash
+npm install @heady/vector-memory
+```
+
+## API
+
+```js
+const { VectorMemoryStore } = require('@heady/vector-memory');
+
+const store = new VectorMemoryStore();
+
+// Store a 3D vector with embedding
+store.store('user-1', {
+  x: 0.5, y: 1.2, z: -0.3,
+  embedding: [0.1, 0.2, 0.3],
+  metadata: { topic: 'ai' },
+  timestamp: Date.now()
+});
+
+// Query by cosine similarity
+const results = store.query('user-1', [0.1, 0.2, 0.3], 5);
+
+// Get stats
+const stats = store.getStats('user-1');
+```
+
+## Features
+
+- **3D spatial indexing** with x/y/z coordinates
+- **Cosine similarity** search across embeddings
+- **Per-user memory isolation**
+- **Octant-based statistics**
+
+## License
+
+Proprietary — © 2026 HeadySystems Inc.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export interface Vector3D {
+    x: number;
+    y: number;
+    z: number;
+    embedding: number[];
+    metadata: Record<string, any>;
+    timestamp: number;
+}
+export declare class VectorMemoryStore {
+    private memories;
+    store(userId: string, memory: Vector3D): void;
+    query(userId: string, embedding: number[], limit?: number): Vector3D[];
+    private cosineSimilarity;
+    getStats(userId: string): {
+        count: number;
+        octants: number;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAsC;IAEtD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI;IAU7C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,SAAK,GAAG,QAAQ,EAAE;IASlE,OAAO,CAAC,gBAAgB;IAOxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAI7D"}

package/dist/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorMemoryStore = void 0;
+const core_1 = require("@heady/core");
+class VectorMemoryStore {
+    memories = new Map();
+    store(userId, memory) {
+        if (!(0, core_1.validateUserId)(userId)) {
+            throw new core_1.HeadyError('Invalid userId', 'INVALID_USER');
+        }
+        if (!this.memories.has(userId)) {
+            this.memories.set(userId, []);
+        }
+        this.memories.get(userId).push(memory);
+    }
+    query(userId, embedding, limit = 10) {
+        const userMemories = this.memories.get(userId) || [];
+        return userMemories
+            .map(m => ({ memory: m, similarity: this.cosineSimilarity(embedding, m.embedding) }))
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit)
+            .map(r => r.memory);
+    }
+    cosineSimilarity(a, b) {
+        const dot = a.reduce((sum, val, i) => sum + val * b[i], 0);
+        const magA = Math.sqrt(a.reduce((sum, val) => sum + val * val, 0));
+        const magB = Math.sqrt(b.reduce((sum, val) => sum + val * val, 0));
+        return dot / (magA * magB);
+    }
+    getStats(userId) {
+        const userMemories = this.memories.get(userId) || [];
+        return { count: userMemories.length, octants: Math.ceil(userMemories.length / 8) };
+    }
+}
+exports.VectorMemoryStore = VectorMemoryStore;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,sCAAyD;AAWzD,MAAa,iBAAiB;IACpB,QAAQ,GAA4B,IAAI,GAAG,EAAE,CAAC;IAEtD,KAAK,CAAC,MAAc,EAAE,MAAgB;QACpC,IAAI,CAAC,IAAA,qBAAc,EAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,iBAAU,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,SAAmB,EAAE,KAAK,GAAG,EAAE;QACnD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,YAAY;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;aACpF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAEO,gBAAgB,CAAC,CAAW,EAAE,CAAW;QAC/C,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;CACF;AAjCD,8CAiCC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "heady-vector-memory",
+  "version": "3.2.0",
+  "description": "3D vector memory store with cosine-similarity search and octree indexing for the Heady AI Platform.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "heady-core": "^3.2.0"
+  },
+  "license": "UNLICENSED",
+  "author": {
+    "name": "HeadySystems Inc.",
+    "email": "eric@headyconnection.org",
+    "url": "https://headyme.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HeadyMe/heady-production.git",
+    "directory": "packages/vector-memory"
+  },
+  "homepage": "https://headysystems.com",
+  "bugs": {
+    "url": "https://github.com/HeadyMe/heady-production/issues"
+  },
+  "keywords": [
+    "heady",
+    "ai",
+    "vector-memory",
+    "3d-vector",
+    "cosine-similarity",
+    "embedding",
+    "octree"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}