@aeriondyseti/vector-memory-mcp 0.9.0-dev.5 → 0.9.0-dev.8

package/dist/src/services/memory.service.js

@@ -0,0 +1,200 @@
+import { randomUUID } from "crypto";
+import { isDeleted } from "../types/memory.js";
+const INTENT_PROFILES = {
+    continuity: { weights: { relevance: 0.3, recency: 0.5, utility: 0.2 }, jitter: 0.02 },
+    fact_check: { weights: { relevance: 0.6, recency: 0.1, utility: 0.3 }, jitter: 0.02 },
+    frequent: { weights: { relevance: 0.2, recency: 0.2, utility: 0.6 }, jitter: 0.02 },
+    associative: { weights: { relevance: 0.7, recency: 0.1, utility: 0.2 }, jitter: 0.05 },
+    explore: { weights: { relevance: 0.4, recency: 0.3, utility: 0.3 }, jitter: 0.15 },
+};
+const sigmoid = (x) => 1 / (1 + Math.exp(-x));
+export class MemoryService {
+    repository;
+    embeddings;
+    constructor(repository, embeddings) {
+        this.repository = repository;
+        this.embeddings = embeddings;
+    }
+    async store(content, metadata = {}, embeddingText) {
+        const id = randomUUID();
+        const now = new Date();
+        const textToEmbed = embeddingText ?? content;
+        const embedding = await this.embeddings.embed(textToEmbed);
+        const memory = {
+            id,
+            content,
+            embedding,
+            metadata,
+            createdAt: now,
+            updatedAt: now,
+            supersededBy: null,
+            usefulness: 0,
+            accessCount: 0,
+            lastAccessed: now, // Initialize to createdAt for fair discovery
+        };
+        await this.repository.insert(memory);
+        return memory;
+    }
+    async get(id) {
+        const memory = await this.repository.findById(id);
+        if (!memory) {
+            return null;
+        }
+        // Track access on explicit get
+        const updatedMemory = {
+            ...memory,
+            accessCount: memory.accessCount + 1,
+            lastAccessed: new Date(),
+        };
+        await this.repository.upsert(updatedMemory);
+        return updatedMemory;
+    }
+    async delete(id) {
+        return await this.repository.markDeleted(id);
+    }
+    async update(id, updates) {
+        const existing = await this.repository.findById(id);
+        if (!existing) {
+            return null;
+        }
+        const newContent = updates.content ?? existing.content;
+        const newMetadata = updates.metadata ?? existing.metadata;
+        // Regenerate embedding if content or embeddingText changed
+        let newEmbedding = existing.embedding;
+        if (updates.content !== undefined || updates.embeddingText !== undefined) {
+            const textToEmbed = updates.embeddingText ?? newContent;
+            newEmbedding = await this.embeddings.embed(textToEmbed);
+        }
+        const updatedMemory = {
+            ...existing,
+            content: newContent,
+            embedding: newEmbedding,
+            metadata: newMetadata,
+            updatedAt: new Date(),
+        };
+        await this.repository.upsert(updatedMemory);
+        return updatedMemory;
+    }
+    async vote(id, value) {
+        const existing = await this.repository.findById(id);
+        if (!existing) {
+            return null;
+        }
+        // Vote also tracks access (explicit utilization signal)
+        const updatedMemory = {
+            ...existing,
+            usefulness: existing.usefulness + value,
+            accessCount: existing.accessCount + 1,
+            lastAccessed: new Date(),
+            updatedAt: new Date(),
+        };
+        await this.repository.upsert(updatedMemory);
+        return updatedMemory;
+    }
+    async search(query, intent, limit = 10, includeDeleted = false) {
+        const queryEmbedding = await this.embeddings.embed(query);
+        const fetchLimit = limit * 5; // Fetch more for re-ranking
+        const candidates = await this.repository.findHybrid(queryEmbedding, query, fetchLimit);
+        const profile = INTENT_PROFILES[intent];
+        const now = new Date();
+        const scored = candidates
+            .filter((m) => includeDeleted || !isDeleted(m))
+            .map((candidate) => {
+            // Relevance: RRF score (already normalized ~0-1)
+            const relevance = candidate.rrfScore;
+            // Recency: exponential decay
+            const lastAccessed = candidate.lastAccessed ?? candidate.createdAt;
+            const hoursSinceAccess = Math.max(0, (now.getTime() - lastAccessed.getTime()) / (1000 * 60 * 60));
+            const recency = Math.pow(0.995, hoursSinceAccess);
+            // Utility: sigmoid of usefulness + log(accessCount)
+            const utility = sigmoid((candidate.usefulness + Math.log(candidate.accessCount + 1)) / 5);
+            // Weighted score
+            const { weights, jitter } = profile;
+            const score = weights.relevance * relevance +
+                weights.recency * recency +
+                weights.utility * utility;
+            // Apply jitter
+            const finalScore = score * (1 + (Math.random() * 2 - 1) * jitter);
+            return { memory: candidate, finalScore };
+        });
+        // Sort by final score descending
+        scored.sort((a, b) => b.finalScore - a.finalScore);
+        // Return top N (read-only - no access tracking)
+        return scored.slice(0, limit).map((s) => s.memory);
+    }
+    async trackAccess(ids) {
+        const now = new Date();
+        for (const id of ids) {
+            const memory = await this.repository.findById(id);
+            if (memory && !isDeleted(memory)) {
+                await this.repository.upsert({
+                    ...memory,
+                    accessCount: memory.accessCount + 1,
+                    lastAccessed: now,
+                });
+            }
+        }
+    }
+    static UUID_ZERO = "00000000-0000-0000-0000-000000000000";
+    async storeHandoff(args) {
+        // Track access for utilized memories
+        if (args.memory_ids && args.memory_ids.length > 0) {
+            await this.trackAccess(args.memory_ids);
+        }
+        const now = new Date();
+        const date = now.toISOString().slice(0, 10);
+        const time = now.toISOString().slice(11, 16);
+        const list = (items) => {
+            if (!items || items.length === 0) {
+                return "- (none)";
+            }
+            return items.map((i) => `- ${i}`).join("\n");
+        };
+        const content = `# Handoff - ${args.project}
+**Date:** ${date} ${time} | **Branch:** ${args.branch ?? "unknown"}
+
+## Summary
+${args.summary}
+
+## Completed
+${list(args.completed)}
+
+## In Progress / Blocked
+${list(args.in_progress_blocked)}
+
+## Key Decisions
+${list(args.key_decisions)}
+
+## Next Steps
+${list(args.next_steps)}
+
+## Memory IDs
+${list(args.memory_ids)}`;
+        const metadata = {
+            ...(args.metadata ?? {}),
+            type: "handoff",
+            project: args.project,
+            date,
+            branch: args.branch ?? "unknown",
+            memory_ids: args.memory_ids ?? [],
+        };
+        const memory = {
+            id: MemoryService.UUID_ZERO,
+            content,
+            embedding: new Array(this.embeddings.dimension).fill(0),
+            metadata,
+            createdAt: now,
+            updatedAt: now,
+            supersededBy: null,
+            usefulness: 0,
+            accessCount: 0,
+            lastAccessed: now, // Initialize to now for consistency
+        };
+        await this.repository.upsert(memory);
+        return memory;
+    }
+    async getLatestHandoff() {
+        return await this.get(MemoryService.UUID_ZERO);
+    }
+}
+//# sourceMappingURL=memory.service.js.map

package/dist/src/services/memory.service.js.map

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

package/dist/src/types/memory.d.ts

@@ -0,0 +1,28 @@
+export declare const DELETED_TOMBSTONE = "DELETED";
+export interface Memory {
+    id: string;
+    content: string;
+    embedding: number[];
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    supersededBy: string | null;
+    usefulness: number;
+    accessCount: number;
+    lastAccessed: Date | null;
+}
+export declare function isDeleted(memory: Memory): boolean;
+export declare function memoryToDict(memory: Memory): Record<string, unknown>;
+export type SearchIntent = 'continuity' | 'fact_check' | 'frequent' | 'associative' | 'explore';
+export interface IntentProfile {
+    weights: {
+        relevance: number;
+        recency: number;
+        utility: number;
+    };
+    jitter: number;
+}
+export interface HybridRow extends Memory {
+    rrfScore: number;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/types/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYpE;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAU,SAAQ,MAAM;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/src/types/memory.js

@@ -0,0 +1,18 @@
+export const DELETED_TOMBSTONE = "DELETED";
+export function isDeleted(memory) {
+    return memory.supersededBy === DELETED_TOMBSTONE;
+}
+export function memoryToDict(memory) {
+    return {
+        id: memory.id,
+        content: memory.content,
+        metadata: memory.metadata,
+        createdAt: memory.createdAt.toISOString(),
+        updatedAt: memory.updatedAt.toISOString(),
+        supersededBy: memory.supersededBy,
+        usefulness: memory.usefulness,
+        accessCount: memory.accessCount,
+        lastAccessed: memory.lastAccessed?.toISOString() ?? null,
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAe3C,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,MAAM,CAAC,YAAY,KAAK,iBAAiB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,IAAI;KACzD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@aeriondyseti/vector-memory-mcp",
-  "version": "0.9.0-dev.5",
+  "version": "0.9.0-dev.8",
   "description": "A zero-configuration RAG memory server for MCP clients",
   "type": "module",
-  "main": "src/index.ts",
+  "main": "dist/src/index.js",
   "bin": {
-    "vector-memory-mcp": "src/index.ts"
+    "vector-memory-mcp": "dist/src/index.js"
   },
   "files": [
+    "dist",
     "src",
     "scripts",
     "hooks",
@@ -24,20 +25,21 @@
   },
   "homepage": "https://github.com/AerionDyseti/vector-memory-mcp#readme",
   "scripts": {
-    "start": "bun run src/index.ts",
+    "start": "node dist/src/index.js",
+    "start:bun": "bun run src/index.ts",
     "dev": "bun --watch run src/index.ts",
-    "build": "bun run typecheck",
+    "build": "tsc",
+    "prebuild": "rm -rf dist",
     "typecheck": "bunx tsc --noEmit",
     "test": "bun run scripts/test-runner.ts",
     "test:raw": "bun test --preload ./tests/preload.ts",
     "test:quick": "bun test",
     "test:coverage": "bun test --preload ./tests/preload.ts --coverage",
+    "benchmark": "bun test tests/benchmark.test.ts --preload ./tests/preload.ts",
     "test:preload": "bun run tests/preload.ts",
     "warmup": "bun run scripts/warmup.ts",
     "postinstall": "bun run scripts/warmup.ts",
-    "publish:check": "bun run scripts/publish.ts --dry-run",
-    "publish:npm": "bun run scripts/publish.ts",
-    "publish:dev": "npm publish --access public --tag dev"
+    "prepublishOnly": "bun run build"
   },
   "keywords": [
     "mcp",
@@ -48,6 +50,7 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@hono/node-server": "^1.19.9",
     "@huggingface/transformers": "^3.8.0",
     "@lancedb/lancedb": "^0.22.3",
     "@modelcontextprotocol/sdk": "^1.0.0",

package/src/config/index.ts

@@ -1,5 +1,8 @@
 import arg from "arg";
-import { join } from "path";
+import { isAbsolute, join } from "path";
+import packageJson from "../../package.json" with { type: "json" };
+
+export const VERSION = packageJson.version;
 
 export type TransportMode = "stdio" | "http" | "both";
 
@@ -28,7 +31,7 @@ const DEFAULT_HTTP_PORT = 3271;
 const DEFAULT_HTTP_HOST = "127.0.0.1";
 
 function resolvePath(path: string): string {
-  return path.startsWith("/") ? path : join(process.cwd(), path);
+  return isAbsolute(path) ? path : join(process.cwd(), path);
 }
 
 export function loadConfig(overrides: ConfigOverrides = {}): Config {

package/src/http/server.ts

@@ -1,11 +1,61 @@
 import { Hono } from "hono";
 import { cors } from "hono/cors";
+import { serve as nodeServe } from "@hono/node-server";
+import { createServer } from "net";
 import type { MemoryService } from "../services/memory.service.js";
 import type { Config } from "../config/index.js";
 import { isDeleted } from "../types/memory.js";
 import { createMcpRoutes } from "./mcp-transport.js";
 import type { Memory, SearchIntent } from "../types/memory.js";
 
+// Detect runtime
+const isBun = typeof globalThis.Bun !== "undefined";
+
+/**
+ * Check if a port is available by attempting to bind to it
+ */
+async function isPortAvailable(port: number, host: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    const server = createServer();
+    server.once("error", () => {
+      resolve(false);
+    });
+    server.once("listening", () => {
+      server.close(() => resolve(true));
+    });
+    server.listen(port, host);
+  });
+}
+
+/**
+ * Find an available port, starting with the preferred port.
+ * If preferred port is unavailable, picks a random available port.
+ */
+async function findAvailablePort(
+  preferredPort: number,
+  host: string
+): Promise<number> {
+  if (await isPortAvailable(preferredPort, host)) {
+    return preferredPort;
+  }
+
+  console.error(
+    `[vector-memory-mcp] Port ${preferredPort} is in use, finding an available port...`
+  );
+
+  // Let the OS pick a random available port
+  return new Promise((resolve, reject) => {
+    const server = createServer();
+    server.once("error", reject);
+    server.once("listening", () => {
+      const address = server.address();
+      const port = typeof address === "object" && address ? address.port : 0;
+      server.close(() => resolve(port));
+    });
+    server.listen(0, host);
+  });
+}
+
 export interface HttpServerOptions {
   memoryService: MemoryService;
   config: Config;
@@ -172,20 +222,43 @@ export function createHttpApp(memoryService: MemoryService, config: Config): Hon
 export async function startHttpServer(
   memoryService: MemoryService,
   config: Config
-): Promise<{ stop: () => void }> {
+): Promise<{ stop: () => void; port: number }> {
   const app = createHttpApp(memoryService, config);
 
-  const server = Bun.serve({
-    port: config.httpPort,
-    hostname: config.httpHost,
-    fetch: app.fetch,
-  });
+  // Find an available port (uses configured port if available, otherwise picks a random one)
+  const actualPort = await findAvailablePort(config.httpPort, config.httpHost);
 
-  console.error(
-    `[vector-memory-mcp] HTTP server listening on http://${config.httpHost}:${config.httpPort}`
-  );
+  if (isBun) {
+    // Use Bun's native server
+    const server = Bun.serve({
+      port: actualPort,
+      hostname: config.httpHost,
+      fetch: app.fetch,
+    });
+
+    console.error(
+      `[vector-memory-mcp] HTTP server listening on http://${config.httpHost}:${actualPort}`
+    );
+
+    return {
+      stop: () => server.stop(),
+      port: actualPort,
+    };
+  } else {
+    // Use Node.js server via @hono/node-server
+    const server = nodeServe({
+      fetch: app.fetch,
+      port: actualPort,
+      hostname: config.httpHost,
+    });
+
+    console.error(
+      `[vector-memory-mcp] HTTP server listening on http://${config.httpHost}:${actualPort}`
+    );
 
-  return {
-    stop: () => server.stop(),
-  };
+    return {
+      stop: () => server.close(),
+      port: actualPort,
+    };
+  }
 }

package/scripts/publish.ts

@@ -1,61 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Publish script for vector-memory-mcp
- *
- * Prerequisites:
- * 1. Create a granular access token at https://www.npmjs.com/settings/tokens
- * 2. Store it: npm config set //registry.npmjs.org/:_authToken=npm_YOUR_TOKEN
- *    Or set NPM_TOKEN environment variable
- *
- * Usage: bun run scripts/publish.ts [--dry-run]
- */
-
-import { $ } from "bun";
-
-const dryRun = process.argv.includes("--dry-run");
-
-async function main() {
-  // Check for authentication
-  console.log("🔐 Checking NPM authentication...");
-  try {
-    const whoami = await $`npm whoami`.text();
-    console.log(`✅ Authenticated as: ${whoami.trim()}`);
-  } catch {
-    console.error("❌ Not authenticated with NPM.");
-    console.error("   Option 1: npm login");
-    console.error("   Option 2: npm config set //registry.npmjs.org/:_authToken=npm_YOUR_TOKEN");
-    console.error("   Option 3: Set NPM_TOKEN environment variable");
-    process.exit(1);
-  }
-
-  // Run tests
-  console.log("🧪 Running tests...");
-  const testResult = await $`bun run test`.quiet();
-  if (testResult.exitCode !== 0) {
-    console.error("❌ Tests failed. Aborting publish.");
-    process.exit(1);
-  }
-  console.log("✅ Tests passed");
-
-  // Build
-  console.log("🔨 Building...");
-  await $`bun run build`;
-  console.log("✅ Build complete");
-
-  // Get version info
-  const pkg = await Bun.file("package.json").json();
-  console.log(`\n📦 Publishing ${pkg.name}@${pkg.version}...`);
-
-  if (dryRun) {
-    console.log("🔍 Dry run - would publish:");
-    await $`npm publish --dry-run`;
-  } else {
-    await $`npm publish --access public`;
-    console.log(`\n✅ Published ${pkg.name}@${pkg.version}`);
-  }
-}
-
-main().catch((err) => {
-  console.error("❌ Publish failed:", err.message);
-  process.exit(1);
-});