@cybermem/mcp 0.9.12 → 0.13.4

package/e2e/api.spec.ts

@@ -0,0 +1,259 @@
+import { expect, test } from "@playwright/test";
+
+const BASE_URL = process.env.MCP_URL
+  ? process.env.MCP_URL.replace(/\/mcp$/, "")
+  : "http://localhost:8626";
+
+// Tailscale environments require auth token
+const isLocalhost =
+  BASE_URL.includes("localhost") || BASE_URL.includes("127.0.0.1");
+const CYBERMEM_TOKEN = process.env.CYBERMEM_TOKEN || "";
+
+// Helper to build headers with optional auth
+function getHeaders(clientName: string): Record<string, string> {
+  const headers: Record<string, string> = { "X-Client-Name": clientName };
+  if (!isLocalhost && CYBERMEM_TOKEN) {
+    headers["X-API-Key"] = CYBERMEM_TOKEN;
+  }
+  return headers;
+}
+
+// CRITICAL: MCP CRUD tests MUST run in serial order (each depends on the previous)
+test.describe.configure({ mode: "serial" });
+
+test.describe("MCP:E2E (Core CRUD)", () => {
+  let memoryId: string;
+  const crudLog: Array<{
+    operation: string;
+    endpoint: string;
+    payload?: object;
+    status: number;
+    response: object;
+  }> = [];
+
+  test.beforeAll(async ({}, testInfo) => {
+    console.log(`🔧 Testing against: ${BASE_URL}`);
+
+    // Attach environment info
+    await testInfo.attach("🔧 Test Environment", {
+      body: `Base URL: ${BASE_URL}\nTimestamp: ${new Date().toISOString()}\nClient: antigravity-client\nVersion: 0.13.0`,
+      contentType: "text/plain",
+    });
+  });
+
+  test("1. Create Memory (POST /add)", async ({ request }, testInfo) => {
+    const payload = {
+      content: `E2E Verification ${new Date().toISOString()}`,
+      tags: ["e2e", "automated"],
+    };
+
+    await test.step("📤 CRUD — POST /add — Create new memory", async () => {
+      console.log("📤 POST /add");
+      console.log("   Payload:", JSON.stringify(payload, null, 2));
+
+      const response = await request.post(`${BASE_URL}/add`, {
+        data: payload,
+        headers: {
+          ...getHeaders("antigravity-client"),
+          "X-Client-Version": "0.13.0",
+        },
+        timeout: 30000, // 30s timeout
+      });
+
+      // Handle non-JSON responses gracefully
+      const status = response.status();
+      let body: any;
+
+      try {
+        body = await response.json();
+      } catch {
+        const text = await response.text();
+        throw new Error(
+          `Non-JSON response (status ${status}): ${text.substring(0, 200)}`,
+        );
+      }
+
+      console.log("   Status:", status);
+      console.log("   Response:", JSON.stringify(body, null, 2));
+
+      crudLog.push({
+        operation: "CREATE",
+        endpoint: "POST /add",
+        payload,
+        status,
+        response: body,
+      });
+
+      expect(status).toBe(200);
+      expect(body.id).toBeTruthy();
+      memoryId = body.id;
+      console.log(`   ✅ Memory ID: ${memoryId}`);
+    });
+
+    // Attach CRUD operation to trace
+    await testInfo.attach("📝 CRUD — CREATE", {
+      body: `Endpoint: POST /add\n\nRequest:\n${JSON.stringify(payload, null, 2)}\n\nResponse:\n${JSON.stringify(crudLog[crudLog.length - 1]?.response, null, 2)}`,
+      contentType: "text/plain",
+    });
+  });
+
+  test("2. Read Memory (POST /query)", async ({ request }, testInfo) => {
+    await test.step("⏳ Wait — Vector Indexing Delay — 1 second", async () => {
+      await new Promise((r) => setTimeout(r, 1000));
+    });
+
+    const payload = { query: "Verification", k: 1 };
+
+    await test.step("📤 CRUD — POST /query — Semantic search", async () => {
+      console.log("📤 POST /query");
+      console.log("   Payload:", JSON.stringify(payload, null, 2));
+
+      const response = await request.post(`${BASE_URL}/query`, {
+        data: payload,
+        headers: getHeaders("antigravity-client"),
+      });
+
+      const body = await response.json();
+      console.log("   Status:", response.status());
+      console.log("   Response:", JSON.stringify(body, null, 2));
+
+      crudLog.push({
+        operation: "READ",
+        endpoint: "POST /query",
+        payload,
+        status: response.status(),
+        response: body,
+      });
+
+      expect(response.status()).toBe(200);
+      expect(Array.isArray(body)).toBe(true);
+      console.log(`   ✅ Returned ${body.length} result(s)`);
+    });
+
+    await testInfo.attach("📖 CRUD — READ", {
+      body: `Endpoint: POST /query\n\nRequest:\n${JSON.stringify(payload, null, 2)}\n\nResponse:\n${JSON.stringify(crudLog[crudLog.length - 1]?.response, null, 2)}`,
+      contentType: "text/plain",
+    });
+  });
+
+  test("3. Update Memory (PATCH /memory/:id)", async ({
+    request,
+  }, testInfo) => {
+    test.skip(!memoryId, "Skipped — memoryId was not created in Step 1");
+
+    const payload = {
+      content: `Updated E2E Context ${new Date().toISOString()}`,
+      tags: ["e2e", "updated"],
+    };
+
+    await test.step(`📤 CRUD — PATCH /memory/${memoryId} — Update content`, async () => {
+      console.log(`📤 PATCH /memory/${memoryId}`);
+      console.log("   Payload:", JSON.stringify(payload, null, 2));
+
+      const response = await request.patch(`${BASE_URL}/memory/${memoryId}`, {
+        data: payload,
+        headers: getHeaders("antigravity-client"),
+      });
+
+      const body = await response.json();
+      console.log("   Status:", response.status());
+      console.log("   Response:", JSON.stringify(body, null, 2));
+
+      crudLog.push({
+        operation: "UPDATE",
+        endpoint: `PATCH /memory/${memoryId}`,
+        payload,
+        status: response.status(),
+        response: body,
+      });
+
+      expect(response.status()).toBe(200);
+      console.log(`   ✅ Memory updated successfully`);
+    });
+
+    await testInfo.attach("✏️ CRUD — UPDATE", {
+      body: `Endpoint: PATCH /memory/${memoryId}\n\nRequest:\n${JSON.stringify(payload, null, 2)}\n\nResponse:\n${JSON.stringify(crudLog[crudLog.length - 1]?.response, null, 2)}`,
+      contentType: "text/plain",
+    });
+  });
+
+  test("4. Reinforce Memory (POST /memory/:id/reinforce)", async ({
+    request,
+  }, testInfo) => {
+    test.skip(!memoryId, "Skipped — memoryId was not created in Step 1");
+
+    const payload = { boost: 0.5 };
+
+    await test.step(`📤 CRUD — POST /memory/${memoryId}/reinforce — Boost salience`, async () => {
+      console.log(`📤 POST /memory/${memoryId}/reinforce`);
+      console.log("   Payload:", JSON.stringify(payload, null, 2));
+
+      const response = await request.post(
+        `${BASE_URL}/memory/${memoryId}/reinforce`,
+        {
+          data: payload,
+          headers: getHeaders("antigravity-client"),
+        },
+      );
+
+      const body = await response.json();
+      console.log("   Status:", response.status());
+      console.log("   Response:", JSON.stringify(body, null, 2));
+
+      crudLog.push({
+        operation: "REINFORCE",
+        endpoint: `POST /memory/${memoryId}/reinforce`,
+        payload,
+        status: response.status(),
+        response: body,
+      });
+
+      expect(response.status()).toBe(200);
+      console.log(`   ✅ Memory reinforced successfully`);
+    });
+
+    await testInfo.attach("⚡ CRUD — REINFORCE", {
+      body: `Endpoint: POST /memory/${memoryId}/reinforce\n\nRequest:\n${JSON.stringify(payload, null, 2)}\n\nResponse:\n${JSON.stringify(crudLog[crudLog.length - 1]?.response, null, 2)}`,
+      contentType: "text/plain",
+    });
+  });
+
+  test("5. Delete Memory (DELETE /memory/:id)", async ({
+    request,
+  }, testInfo) => {
+    test.skip(!memoryId, "Skipped — memoryId was not created in Step 1");
+
+    await test.step(`📤 CRUD — DELETE /memory/${memoryId} — Hard delete from DB`, async () => {
+      console.log(`📤 DELETE /memory/${memoryId}`);
+
+      const response = await request.delete(`${BASE_URL}/memory/${memoryId}`, {
+        headers: getHeaders("antigravity-client"),
+      });
+
+      const body = await response.json();
+      console.log("   Status:", response.status());
+      console.log("   Response:", JSON.stringify(body, null, 2));
+
+      crudLog.push({
+        operation: "DELETE",
+        endpoint: `DELETE /memory/${memoryId}`,
+        status: response.status(),
+        response: body,
+      });
+
+      expect(response.status()).toBe(200);
+      console.log(`   ✅ Memory deleted successfully`);
+    });
+
+    await testInfo.attach("🗑️ CRUD — DELETE", {
+      body: `Endpoint: DELETE /memory/${memoryId}\n\nResponse:\n${JSON.stringify(crudLog[crudLog.length - 1]?.response, null, 2)}\n\n--- FULL CRUD LOG ---\n${crudLog.map((c) => `${c.operation}: ${c.endpoint} → ${c.status}`).join("\n")}`,
+      contentType: "text/plain",
+    });
+
+    // Attach full CRUD summary at the end
+    await testInfo.attach("📊 CRUD Lifecycle Complete", {
+      body: `Memory ID: ${memoryId}\n\nOperations Performed:\n${crudLog.map((c) => `✅ ${c.operation}: ${c.endpoint} → HTTP ${c.status}`).join("\n")}\n\nStorage State: CLEANED (memory deleted)`,
+      contentType: "text/plain",
+    });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cybermem/mcp",
-  "version": "0.9.12",
+  "version": "0.13.4",
   "description": "CyberMem MCP Server - AI Memory with openmemory-js SDK",
   "main": "dist/index.js",
   "bin": {
@@ -9,7 +9,9 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "ts-node src/index.ts"
+    "dev": "ts-node src/index.ts",
+    "lint": "tsc --noEmit",
+    "test:e2e": "playwright test"
   },
   "repository": {
     "type": "git",
@@ -39,14 +41,14 @@
     "cors": "^2.8.5",
     "dotenv": "^16.0.0",
     "express": "^5.2.1",
-    "keytar": "^7.9.0",
     "open": "^11.0.0",
-    "openmemory-js": "^1.3.2",
+    "openmemory-js": "1.3.0",
     "sqlite": "^5.1.1",
     "sqlite3": "^5.1.7",
     "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@playwright/test": "^1.57.0",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/node": "^18.0.0",

package/playwright.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from "@playwright/test";
+
+export default defineConfig({
+  testDir: "./e2e",
+  outputDir: "./test-results",
+  reporter: "html",
+  use: {
+    baseURL: process.env.MCP_URL || "http://localhost:8626/mcp",
+    trace: "on-first-retry",
+  },
+  projects: [
+    {
+      name: "api",
+      testMatch: "api.spec.ts",
+    },
+  ],
+});

package/src/console-fix.ts

@@ -0,0 +1,13 @@
+// Redirect all stdout to stderr IMMEDIATELY to protect Stdio protocol
+const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+(process.stdout as any).write = (chunk: any, encoding: any, callback: any) => {
+  const str = typeof chunk === "string" ? chunk : chunk.toString();
+  if (str.includes('"jsonrpc":')) {
+    return originalStdoutWrite(chunk, encoding, callback);
+  }
+  return process.stderr.write(chunk, encoding, callback);
+};
+
+// Also redirect console outputs
+console.log = console.error;
+console.info = console.error;

package/src/env.ts

@@ -1,10 +1,27 @@
-/**
- * Environment Initialization for CyberMem MCP
- * Must be imported first to set side-effect vars.
- */
 import dotenv from "dotenv";
+import os from "os";
+import path from "path";
+
 dotenv.config();
 
+// CLI Enforcement: Ensure CyberMem is deployed via @cybermem/cli
+if (!process.env.CYBERMEM_INSTANCE) {
+  console.error(
+    "\n❌ FATAL: CyberMem must be started via @cybermem/cli ('mcp install' or 'mcp up').",
+  );
+  console.error(
+    "Manual 'npm start' or 'docker-compose up' without CLI tagging is forbidden.\n",
+  );
+  process.exit(1);
+}
+
+// Normalize OM_DB_PATH early so all components (SDK, exporters) use the same file
+const homedir = os.homedir();
+process.env.OM_DB_PATH =
+  process.env.OM_DB_PATH ||
+  path.resolve(homedir, ".cybermem/data/openmemory.sqlite");
+process.env.DB_PATH = process.env.OM_DB_PATH;
+
 process.env.OM_TIER = process.env.OM_TIER || "hybrid";
 process.env.OM_PORT = process.env.OM_PORT || "0";
 process.env.PORT = process.env.PORT || "0";