havensdk-store 0.1.0

package/dist/vector.d.ts

@@ -0,0 +1,36 @@
+export interface VectorSearchResult {
+    id: string;
+    score: number;
+    metadata: Record<string, unknown>;
+    content: string;
+}
+export interface VectorStore {
+    save(content: string, metadata: Record<string, unknown>): Promise<string>;
+    search(query: string, options?: {
+        limit?: number;
+    }): Promise<VectorSearchResult[]>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * Simple hash-based vector store for local-first operation.
+ * Uses SimHash-like approach for similarity scoring.
+ * No external API dependency - works entirely locally.
+ */
+export declare class HashVectorStore implements VectorStore {
+    private embeddings;
+    private idCounter;
+    /**
+     * Generate a simple hash-based embedding vector (128 dimensions)
+     */
+    private generateEmbedding;
+    /**
+     * Compute cosine similarity between two vectors
+     */
+    private cosineSimilarity;
+    save(content: string, metadata?: Record<string, unknown>): Promise<string>;
+    search(query: string, options?: {
+        limit?: number;
+    }): Promise<VectorSearchResult[]>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=vector.d.ts.map

package/dist/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../src/vector.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,UAAU,CAAgG;IAClH,OAAO,CAAC,SAAS,CAAK;IAEtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWlB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAoBlF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/vector.js

@@ -0,0 +1,76 @@
+import { createHash } from "crypto";
+/**
+ * Simple hash-based vector store for local-first operation.
+ * Uses SimHash-like approach for similarity scoring.
+ * No external API dependency - works entirely locally.
+ */
+export class HashVectorStore {
+    embeddings = new Map();
+    idCounter = 0;
+    /**
+     * Generate a simple hash-based embedding vector (128 dimensions)
+     */
+    generateEmbedding(text) {
+        const normalized = text.toLowerCase().trim();
+        const tokens = normalized.split(/\s+/).filter(t => t.length > 0);
+        // Create 128-dimensional vector from n-gram hashes
+        const dimensions = 128;
+        const vector = new Float32Array(dimensions);
+        for (let n = 1; n <= 3; n++) {
+            for (let i = 0; i <= tokens.length - n; i++) {
+                const ngram = tokens.slice(i, i + n).join(" ");
+                const hash = createHash("sha256").update(ngram).digest();
+                for (let j = 0; j < Math.min(32, dimensions); j++) {
+                    vector[j * 4 % dimensions] += hash[j] / 255;
+                }
+            }
+        }
+        // Normalize
+        const magnitude = Math.sqrt(vector.reduce((sum, v) => sum + v * v, 0));
+        if (magnitude > 0) {
+            for (let i = 0; i < dimensions; i++) {
+                vector[i] /= magnitude;
+            }
+        }
+        return Buffer.from(vector.buffer);
+    }
+    /**
+     * Compute cosine similarity between two vectors
+     */
+    cosineSimilarity(a, b) {
+        const va = new Float32Array(a.buffer, a.byteOffset, a.byteLength / 4);
+        const vb = new Float32Array(b.buffer, b.byteOffset, b.byteLength / 4);
+        let dot = 0;
+        for (let i = 0; i < va.length; i++) {
+            dot += va[i] * vb[i];
+        }
+        return dot; // Already normalized, so dot = cosine
+    }
+    async save(content, metadata = {}) {
+        const id = `vec_${++this.idCounter}_${Date.now()}`;
+        const hash = this.generateEmbedding(content);
+        this.embeddings.set(id, { hash, metadata, content });
+        return id;
+    }
+    async search(query, options) {
+        const limit = options?.limit ?? 5;
+        const queryHash = this.generateEmbedding(query);
+        const results = [];
+        for (const [id, data] of this.embeddings) {
+            const score = this.cosineSimilarity(queryHash, data.hash);
+            results.push({
+                id,
+                score,
+                metadata: data.metadata,
+                content: data.content,
+            });
+        }
+        // Sort by score descending
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    async delete(id) {
+        this.embeddings.delete(id);
+    }
+}
+//# sourceMappingURL=vector.js.map

package/dist/vector.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "havensdk-store",
+  "version": "0.1.0",
+  "description": "SQLite-backed persistence for Haven runs and state.",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/doanbactam/haven.git"
+  },
+  "bugs": {
+    "url": "https://github.com/doanbactam/haven/issues"
+  },
+  "homepage": "https://github.com/doanbactam/haven#readme",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "sqlite",
+    "store",
+    "agents",
+    "typescript",
+    "bun"
+  ],
+  "license": "MIT",
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "test": "bun test",
+    "types": "tsc --noEmit",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build && bun run build:cjs && bun run types && bun test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "havensdk": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  }
+}