@knowledgine/mcp-memory-protocol 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 R.M
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/conformance/capabilities.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runCapabilitiesTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=capabilities.test-suite.d.ts.map

package/dist/conformance/capabilities.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/capabilities.test-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0B9B"}

package/dist/conformance/capabilities.test-suite.js

@@ -0,0 +1,29 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runCapabilitiesTests(ctx) {
+    const results = [];
+    // get_memory_capabilities: tool exists and returns valid structure
+    try {
+        const r = await callTool(ctx.client, "get_memory_capabilities", {});
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (typeof d.versioning !== "boolean")
+            throw new Error(`Expected boolean versioning, got: ${typeof d.versioning}`);
+        if (typeof d.semanticSearch !== "boolean")
+            throw new Error(`Expected boolean semanticSearch, got: ${typeof d.semanticSearch}`);
+        if (typeof d.layerPromotion !== "boolean")
+            throw new Error(`Expected boolean layerPromotion, got: ${typeof d.layerPromotion}`);
+        if (typeof d.temporalQuery !== "boolean")
+            throw new Error(`Expected boolean temporalQuery, got: ${typeof d.temporalQuery}`);
+        if (typeof d.ttl !== "boolean")
+            throw new Error(`Expected boolean ttl, got: ${typeof d.ttl}`);
+        if (!Array.isArray(d.supportedLayers))
+            throw new Error("Expected array supportedLayers");
+        results.push(makeResult("get_memory_capabilities: returns valid capability structure", true));
+    }
+    catch (e) {
+        results.push(makeResult("get_memory_capabilities: returns valid capability structure", false, String(e)));
+    }
+    return results;
+}
+//# sourceMappingURL=capabilities.test-suite.js.map

package/dist/conformance/capabilities.test-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.test-suite.js","sourceRoot":"","sources":["../../src/conformance/capabilities.test-suite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAA2B;IAE3B,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,mEAAmE;IACnE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,IAA+B,CAAC;QAC5C,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,SAAS;YACnC,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,SAAS;YACvC,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QACtF,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,SAAS;YACvC,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QACtF,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,SAAS;YACtC,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;QACpF,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,6DAA6D,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,6DAA6D,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAC5F,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/conformance/error-format.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runErrorFormatTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=error-format.test-suite.d.ts.map

package/dist/conformance/error-format.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-format.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/error-format.test-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuC9B"}

package/dist/conformance/error-format.test-suite.js

@@ -0,0 +1,40 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runErrorFormatTests(ctx) {
+    const results = [];
+    // Error format: MEMORY_NOT_FOUND returns isError: true
+    try {
+        const r = await callTool(ctx.client, "forget_memory", { id: "nonexistent-id-for-conformance" });
+        if (!r.isError)
+            throw new Error("Expected isError: true for MEMORY_NOT_FOUND");
+        results.push(makeResult("error format: MEMORY_NOT_FOUND returns isError: true", true));
+    }
+    catch (e) {
+        results.push(makeResult("error format: MEMORY_NOT_FOUND returns isError: true", false, String(e)));
+    }
+    // Error format: error code is present in text content
+    try {
+        const r = await callTool(ctx.client, "forget_memory", { id: "nonexistent-id-for-conformance" });
+        if (!r.isError)
+            throw new Error("Expected error response");
+        if (!r.text.includes("MEMORY_NOT_FOUND"))
+            throw new Error(`Expected error code in text, got: ${r.text}`);
+        results.push(makeResult("error format: error code present in text content", true));
+    }
+    catch (e) {
+        results.push(makeResult("error format: error code present in text content", false, String(e)));
+    }
+    // Error format: INVALID_CONTENT returns isError: true
+    try {
+        const r = await callTool(ctx.client, "store_memory", { content: "" });
+        if (!r.isError)
+            throw new Error("Expected isError: true for INVALID_CONTENT");
+        if (!r.text.includes("INVALID_CONTENT"))
+            throw new Error(`Expected INVALID_CONTENT code in text, got: ${r.text}`);
+        results.push(makeResult("error format: INVALID_CONTENT returns isError: true", true));
+    }
+    catch (e) {
+        results.push(makeResult("error format: INVALID_CONTENT returns isError: true", false, String(e)));
+    }
+    return results;
+}
+//# sourceMappingURL=error-format.test-suite.js.map

package/dist/conformance/error-format.test-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-format.test-suite.js","sourceRoot":"","sources":["../../src/conformance/error-format.test-suite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAA2B;IAE3B,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,uDAAuD;IACvD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,gCAAgC,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,sDAAsD,EAAE,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,sDAAsD,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CACrF,CAAC;IACJ,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,gCAAgC,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC3D,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,kDAAkD,EAAE,IAAI,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,kDAAkD,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC9E,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,qDAAqD,EAAE,IAAI,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,qDAAqD,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CACpF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/conformance/forget.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runForgetTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=forget.test-suite.d.ts.map

package/dist/conformance/forget.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/forget.test-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,cAAc,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsD9F"}

package/dist/conformance/forget.test-suite.js

@@ -0,0 +1,60 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runForgetTests(ctx) {
+    const results = [];
+    // forget_memory: soft delete (default)
+    try {
+        const storeR = await callTool(ctx.client, "store_memory", {
+            content: "Memory to soft-forget",
+            layer: "episodic",
+        });
+        const id = storeR.data.id;
+        const r = await callTool(ctx.client, "forget_memory", { id, reason: "test soft forget" });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (d.id !== id)
+            throw new Error(`Expected id=${id}, got ${String(d.id)}`);
+        if (d.forgotten !== true)
+            throw new Error("Expected forgotten=true");
+        if (d.method !== "soft")
+            throw new Error(`Expected method=soft, got ${String(d.method)}`);
+        results.push(makeResult("forget_memory: soft delete success", true));
+    }
+    catch (e) {
+        results.push(makeResult("forget_memory: soft delete success", false, String(e)));
+    }
+    // forget_memory: hard delete
+    try {
+        const storeR = await callTool(ctx.client, "store_memory", {
+            content: "Memory to hard-forget",
+            layer: "episodic",
+        });
+        const id = storeR.data.id;
+        const r = await callTool(ctx.client, "forget_memory", { id, hard: true });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (d.forgotten !== true)
+            throw new Error("Expected forgotten=true");
+        if (d.method !== "hard")
+            throw new Error(`Expected method=hard, got ${String(d.method)}`);
+        results.push(makeResult("forget_memory: hard delete success", true));
+    }
+    catch (e) {
+        results.push(makeResult("forget_memory: hard delete success", false, String(e)));
+    }
+    // forget_memory: MEMORY_NOT_FOUND
+    try {
+        const r = await callTool(ctx.client, "forget_memory", { id: "non-existent-id-xyz" });
+        if (!r.isError)
+            throw new Error("Expected error for non-existent id");
+        if (!r.text.includes("MEMORY_NOT_FOUND"))
+            throw new Error(`Expected MEMORY_NOT_FOUND, got: ${r.text}`);
+        results.push(makeResult("forget_memory: MEMORY_NOT_FOUND for non-existent id", true));
+    }
+    catch (e) {
+        results.push(makeResult("forget_memory: MEMORY_NOT_FOUND for non-existent id", false, String(e)));
+    }
+    return results;
+}
+//# sourceMappingURL=forget.test-suite.js.map

package/dist/conformance/forget.test-suite.js.map

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

package/dist/conformance/helpers.d.ts

@@ -0,0 +1,16 @@
+import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
+export interface ConformanceTestContext {
+    client: Client;
+}
+export interface ConformanceResult {
+    name: string;
+    passed: boolean;
+    error?: string;
+}
+export declare function callTool(client: Client, toolName: string, args: Record<string, unknown>): Promise<{
+    isError: boolean;
+    text: string;
+    data: unknown;
+}>;
+export declare function makeResult(name: string, passed: boolean, error?: string): ConformanceResult;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/conformance/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/conformance/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAW5D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAE3F"}

package/dist/conformance/helpers.js

@@ -0,0 +1,17 @@
+export async function callTool(client, toolName, args) {
+    const result = await client.callTool({ name: toolName, arguments: args });
+    const content = result.content;
+    const text = content[0]?.text ?? "";
+    let data = null;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        data = text;
+    }
+    return { isError: result.isError === true, text, data };
+}
+export function makeResult(name, passed, error) {
+    return { name, passed, error };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/conformance/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/conformance/helpers.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,QAAgB,EAChB,IAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAgD,CAAC;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACpC,IAAI,IAAI,GAAY,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAe,EAAE,KAAc;IACtE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/conformance/index.d.ts

@@ -0,0 +1,17 @@
+export type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export { runStoreTests } from "./store.test-suite.js";
+export { runRecallTests } from "./recall.test-suite.js";
+export { runUpdateTests } from "./update.test-suite.js";
+export { runForgetTests } from "./forget.test-suite.js";
+export { runVersioningTests } from "./versioning.test-suite.js";
+export { runErrorFormatTests } from "./error-format.test-suite.js";
+export { runCapabilitiesTests } from "./capabilities.test-suite.js";
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export interface ConformanceSuiteOptions {
+    includeVersioning?: boolean;
+    includeCapabilities?: boolean;
+    /** Include error-format tests (default: true). Set false if your test suite already covers error formats independently. */
+    includeErrorFormat?: boolean;
+}
+export declare function runConformanceSuite(ctx: ConformanceTestContext, options?: ConformanceSuiteOptions): Promise<ConformanceResult[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAS9E,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2HAA2H;IAC3H,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,sBAAsB,EAC3B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgB9B"}

package/dist/conformance/index.js

@@ -0,0 +1,32 @@
+export { runStoreTests } from "./store.test-suite.js";
+export { runRecallTests } from "./recall.test-suite.js";
+export { runUpdateTests } from "./update.test-suite.js";
+export { runForgetTests } from "./forget.test-suite.js";
+export { runVersioningTests } from "./versioning.test-suite.js";
+export { runErrorFormatTests } from "./error-format.test-suite.js";
+export { runCapabilitiesTests } from "./capabilities.test-suite.js";
+import { runStoreTests } from "./store.test-suite.js";
+import { runRecallTests } from "./recall.test-suite.js";
+import { runUpdateTests } from "./update.test-suite.js";
+import { runForgetTests } from "./forget.test-suite.js";
+import { runVersioningTests } from "./versioning.test-suite.js";
+import { runErrorFormatTests } from "./error-format.test-suite.js";
+import { runCapabilitiesTests } from "./capabilities.test-suite.js";
+export async function runConformanceSuite(ctx, options = {}) {
+    const results = [];
+    results.push(...(await runStoreTests(ctx)));
+    results.push(...(await runRecallTests(ctx)));
+    results.push(...(await runUpdateTests(ctx)));
+    results.push(...(await runForgetTests(ctx)));
+    if (options.includeErrorFormat !== false) {
+        results.push(...(await runErrorFormatTests(ctx)));
+    }
+    if (options.includeVersioning) {
+        results.push(...(await runVersioningTests(ctx)));
+    }
+    if (options.includeCapabilities) {
+        results.push(...(await runCapabilitiesTests(ctx)));
+    }
+    return results;
+}
+//# sourceMappingURL=index.js.map

package/dist/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AASpE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAA2B,EAC3B,UAAmC,EAAE;IAErC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,kBAAkB,KAAK,KAAK,EAAE,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/conformance/recall.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runRecallTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=recall.test-suite.d.ts.map

package/dist/conformance/recall.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/recall.test-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,cAAc,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmH9F"}

package/dist/conformance/recall.test-suite.js

@@ -0,0 +1,130 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runRecallTests(ctx) {
+    const results = [];
+    // Seed a memory first
+    let seedId;
+    try {
+        const r = await callTool(ctx.client, "store_memory", {
+            content: "Recall conformance test seed",
+            layer: "episodic",
+            tags: ["conformance"],
+        });
+        seedId = r.data.id;
+    }
+    catch {
+        // will fail in later tests
+    }
+    // recall_memory: no query returns memories array
+    try {
+        const r = await callTool(ctx.client, "recall_memory", {});
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (!Array.isArray(d.memories))
+            throw new Error("Response missing memories array");
+        if (typeof d.totalCount !== "number")
+            throw new Error("Missing totalCount");
+        if (typeof d.hasMore !== "boolean")
+            throw new Error("Missing hasMore");
+        results.push(makeResult("recall_memory: returns memories/totalCount/hasMore", true));
+    }
+    catch (e) {
+        results.push(makeResult("recall_memory: returns memories/totalCount/hasMore", false, String(e)));
+    }
+    // recall_memory: with query
+    try {
+        const r = await callTool(ctx.client, "recall_memory", { query: "conformance test seed" });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (!Array.isArray(d.memories))
+            throw new Error("Missing memories array");
+        results.push(makeResult("recall_memory: with query", true));
+    }
+    catch (e) {
+        results.push(makeResult("recall_memory: with query", false, String(e)));
+    }
+    // recall_memory: each memory has required fields
+    try {
+        const r = await callTool(ctx.client, "recall_memory", { query: "conformance test seed" });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        const memories = d.memories;
+        if (memories.length === 0)
+            throw new Error("Expected at least one result");
+        const m = memories[0];
+        if (!m.id || typeof m.id !== "string")
+            throw new Error("Missing string id");
+        if (!m.content || typeof m.content !== "string")
+            throw new Error("Missing content");
+        if (!m.layer)
+            throw new Error("Missing layer");
+        if (typeof m.version !== "number")
+            throw new Error("Missing version");
+        if (typeof m.accessCount !== "number")
+            throw new Error("Missing accessCount");
+        if (!Array.isArray(m.tags))
+            throw new Error("Missing tags array");
+        if (!m.createdAt)
+            throw new Error("Missing createdAt");
+        results.push(makeResult("recall_memory: memory has required fields", true));
+    }
+    catch (e) {
+        results.push(makeResult("recall_memory: memory has required fields", false, String(e)));
+    }
+    // recall_memory: filter by layer
+    try {
+        const r = await callTool(ctx.client, "recall_memory", {
+            filter: { layer: "episodic" },
+        });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        const memories = d.memories;
+        for (const m of memories) {
+            if (m.layer !== "episodic")
+                throw new Error(`Expected episodic, got ${String(m.layer)}`);
+        }
+        results.push(makeResult("recall_memory: filter by layer", true));
+    }
+    catch (e) {
+        results.push(makeResult("recall_memory: filter by layer", false, String(e)));
+    }
+    // recall_memory: limit respected
+    try {
+        const r = await callTool(ctx.client, "recall_memory", { limit: 1 });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        const memories = d.memories;
+        if (memories.length > 1)
+            throw new Error(`Expected at most 1 result, got ${memories.length}`);
+        results.push(makeResult("recall_memory: limit respected", true));
+    }
+    catch (e) {
+        results.push(makeResult("recall_memory: limit respected", false, String(e)));
+    }
+    // recall_memory: accessCount incremented on recall (SHOULD)
+    if (seedId) {
+        try {
+            const r1 = await callTool(ctx.client, "recall_memory", {
+                filter: { memoryIds: [seedId] },
+            });
+            const before = r1.data.memories[0]?.accessCount;
+            await callTool(ctx.client, "recall_memory", { filter: { memoryIds: [seedId] } });
+            const r2 = await callTool(ctx.client, "recall_memory", {
+                filter: { memoryIds: [seedId] },
+            });
+            const after = r2.data.memories[0]?.accessCount;
+            if (after <= before)
+                throw new Error(`accessCount not incremented: before=${before}, after=${after}`);
+            results.push(makeResult("recall_memory: accessCount incremented (SHOULD)", true));
+        }
+        catch (e) {
+            results.push(makeResult("recall_memory: accessCount incremented (SHOULD)", false, String(e)));
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=recall.test-suite.js.map

package/dist/conformance/recall.test-suite.js.map

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

package/dist/conformance/store.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runStoreTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=store.test-suite.d.ts.map

package/dist/conformance/store.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/store.test-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,aAAa,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyE7F"}

package/dist/conformance/store.test-suite.js

@@ -0,0 +1,85 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runStoreTests(ctx) {
+    const results = [];
+    // store_memory: basic success
+    try {
+        const r = await callTool(ctx.client, "store_memory", {
+            content: "Test memory entry",
+            layer: "episodic",
+        });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (!d.id || typeof d.id !== "string")
+            throw new Error("Response missing string id");
+        if (d.layer !== "episodic")
+            throw new Error(`Expected layer=episodic, got ${String(d.layer)}`);
+        if (d.version !== 1)
+            throw new Error(`Expected version=1, got ${String(d.version)}`);
+        if (!d.createdAt || typeof d.createdAt !== "string")
+            throw new Error("Missing createdAt");
+        results.push(makeResult("store_memory: basic success", true));
+    }
+    catch (e) {
+        results.push(makeResult("store_memory: basic success", false, String(e)));
+    }
+    // store_memory: defaults layer to episodic
+    try {
+        const r = await callTool(ctx.client, "store_memory", { content: "No layer specified" });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (d.layer !== "episodic")
+            throw new Error(`Expected default layer=episodic, got ${String(d.layer)}`);
+        results.push(makeResult("store_memory: defaults to episodic layer", true));
+    }
+    catch (e) {
+        results.push(makeResult("store_memory: defaults to episodic layer", false, String(e)));
+    }
+    // store_memory: INVALID_CONTENT for empty string
+    try {
+        const r = await callTool(ctx.client, "store_memory", { content: "" });
+        if (!r.isError)
+            throw new Error("Expected error for empty content");
+        if (!r.text.includes("INVALID_CONTENT"))
+            throw new Error(`Expected INVALID_CONTENT in error, got: ${r.text}`);
+        results.push(makeResult("store_memory: INVALID_CONTENT for empty content", true));
+    }
+    catch (e) {
+        results.push(makeResult("store_memory: INVALID_CONTENT for empty content", false, String(e)));
+    }
+    // store_memory: INVALID_LAYER for bad layer value
+    try {
+        const r = await callTool(ctx.client, "store_memory", {
+            content: "test",
+            layer: "invalid_layer",
+        });
+        if (!r.isError)
+            throw new Error("Expected error for invalid layer");
+        if (!r.text.includes("INVALID_LAYER"))
+            throw new Error(`Expected INVALID_LAYER in error, got: ${r.text}`);
+        results.push(makeResult("store_memory: INVALID_LAYER for bad layer", true));
+    }
+    catch (e) {
+        results.push(makeResult("store_memory: INVALID_LAYER for bad layer", false, String(e)));
+    }
+    // store_memory: with tags and metadata
+    try {
+        const r = await callTool(ctx.client, "store_memory", {
+            content: "Memory with tags",
+            tags: ["tag1", "tag2"],
+            metadata: { source: "test", project: "conformance" },
+        });
+        if (r.isError)
+            throw new Error(`Unexpected error: ${r.text}`);
+        const d = r.data;
+        if (!d.id)
+            throw new Error("Missing id in response");
+        results.push(makeResult("store_memory: with tags and metadata", true));
+    }
+    catch (e) {
+        results.push(makeResult("store_memory: with tags and metadata", false, String(e)));
+    }
+    return results;
+}
+//# sourceMappingURL=store.test-suite.js.map

package/dist/conformance/store.test-suite.js.map

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

package/dist/conformance/update.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runUpdateTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=update.test-suite.d.ts.map

package/dist/conformance/update.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/update.test-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,cAAc,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqD9F"}

package/dist/conformance/update.test-suite.js

@@ -0,0 +1,56 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runUpdateTests(ctx) {
+    const results = [];
+    // Seed a memory to update
+    let seedId;
+    try {
+        const r = await callTool(ctx.client, "store_memory", {
+            content: "Original content for update test",
+            layer: "episodic",
+        });
+        seedId = r.data.id;
+    }
+    catch {
+        // will fail in later tests
+    }
+    // update_memory: in-place update (createVersion: false)
+    if (seedId) {
+        try {
+            const r = await callTool(ctx.client, "update_memory", {
+                id: seedId,
+                content: "Updated content",
+                createVersion: false,
+            });
+            if (r.isError)
+                throw new Error(`Unexpected error: ${r.text}`);
+            const d = r.data;
+            if (!d.id || typeof d.id !== "string")
+                throw new Error("Missing id");
+            if (typeof d.version !== "number")
+                throw new Error("Missing version");
+            if (!d.updatedAt || typeof d.updatedAt !== "string")
+                throw new Error("Missing updatedAt");
+            results.push(makeResult("update_memory: in-place update (createVersion: false)", true));
+        }
+        catch (e) {
+            results.push(makeResult("update_memory: in-place update (createVersion: false)", false, String(e)));
+        }
+    }
+    // update_memory: MEMORY_NOT_FOUND for non-existent id
+    try {
+        const r = await callTool(ctx.client, "update_memory", {
+            id: "non-existent-id-xyz",
+            content: "updated",
+        });
+        if (!r.isError)
+            throw new Error("Expected error for non-existent id");
+        if (!r.text.includes("MEMORY_NOT_FOUND"))
+            throw new Error(`Expected MEMORY_NOT_FOUND, got: ${r.text}`);
+        results.push(makeResult("update_memory: MEMORY_NOT_FOUND for non-existent id", true));
+    }
+    catch (e) {
+        results.push(makeResult("update_memory: MEMORY_NOT_FOUND for non-existent id", false, String(e)));
+    }
+    return results;
+}
+//# sourceMappingURL=update.test-suite.js.map

package/dist/conformance/update.test-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.test-suite.js","sourceRoot":"","sources":["../../src/conformance/update.test-suite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAA2B;IAC9D,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,0BAA0B;IAC1B,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE;YACnD,OAAO,EAAE,kCAAkC;YAC3C,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QACH,MAAM,GAAI,CAAC,CAAC,IAAgC,CAAC,EAAY,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,wDAAwD;IACxD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE;gBACpD,EAAE,EAAE,MAAM;gBACV,OAAO,EAAE,iBAAiB;gBAC1B,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,IAA+B,CAAC;YAC5C,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YACrE,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACtE,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC1F,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,uDAAuD,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,uDAAuD,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CACtF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE;YACpD,EAAE,EAAE,qBAAqB;YACzB,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,qDAAqD,EAAE,IAAI,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,qDAAqD,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CACpF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/conformance/versioning.test-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ConformanceTestContext, ConformanceResult } from "./helpers.js";
+export declare function runVersioningTests(ctx: ConformanceTestContext): Promise<ConformanceResult[]>;
+//# sourceMappingURL=versioning.test-suite.d.ts.map

package/dist/conformance/versioning.test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.test-suite.d.ts","sourceRoot":"","sources":["../../src/conformance/versioning.test-suite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkE9B"}

package/dist/conformance/versioning.test-suite.js

@@ -0,0 +1,67 @@
+import { callTool, makeResult } from "./helpers.js";
+export async function runVersioningTests(ctx) {
+    const results = [];
+    // Seed a memory to version
+    let seedId;
+    let seedVersion;
+    try {
+        const r = await callTool(ctx.client, "store_memory", {
+            content: "Original content for versioning test",
+            layer: "episodic",
+        });
+        const d = r.data;
+        seedId = d.id;
+        seedVersion = d.version;
+    }
+    catch {
+        // will fail in later tests
+    }
+    // update_memory: createVersion=true creates new entry
+    if (seedId && seedVersion !== undefined) {
+        try {
+            const r = await callTool(ctx.client, "update_memory", {
+                id: seedId,
+                content: "Updated versioned content",
+                createVersion: true,
+            });
+            if (r.isError)
+                throw new Error(`Unexpected error: ${r.text}`);
+            const d = r.data;
+            const newId = d.id;
+            const newVersion = d.version;
+            const prevVersion = d.previousVersion;
+            if (newId === seedId)
+                throw new Error("New version should have a different id");
+            if (newVersion !== seedVersion + 1)
+                throw new Error(`Expected version=${seedVersion + 1}, got ${newVersion}`);
+            if (prevVersion !== seedVersion)
+                throw new Error(`Expected previousVersion=${seedVersion}, got ${prevVersion}`);
+            results.push(makeResult("versioning: update creates new id with incremented version", true));
+        }
+        catch (e) {
+            results.push(makeResult("versioning: update creates new id with incremented version", false, String(e)));
+        }
+    }
+    // recall_memory: includeVersionHistory=false excludes deprecated by default
+    if (seedId) {
+        try {
+            const r = await callTool(ctx.client, "recall_memory", {
+                filter: { memoryIds: [seedId] },
+                includeVersionHistory: false,
+            });
+            if (r.isError)
+                throw new Error(`Unexpected error: ${r.text}`);
+            const d = r.data;
+            const memories = d.memories;
+            const deprecated = memories.filter((m) => m.deprecated === true);
+            if (deprecated.length > 0)
+                throw new Error("Deprecated entries should be excluded by default");
+            results.push(makeResult("versioning: includeVersionHistory=false excludes deprecated", true));
+        }
+        catch (e) {
+            results.push(makeResult("versioning: includeVersionHistory=false excludes deprecated", false, String(e)));
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=versioning.test-suite.js.map

package/dist/conformance/versioning.test-suite.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export type MemoryErrorCode = "MEMORY_NOT_FOUND" | "INVALID_CONTENT" | "INVALID_LAYER" | "INVALID_PARAMETER" | "VERSION_CONFLICT" | "STORAGE_ERROR" | "CAPABILITY_NOT_SUPPORTED";
+export declare class MemoryProtocolError extends Error {
+    readonly code: MemoryErrorCode;
+    constructor(code: MemoryErrorCode, message: string);
+}
+export declare function memoryNotFound(id: string): MemoryProtocolError;
+export declare function invalidContent(): MemoryProtocolError;
+export declare function invalidLayer(value: string): MemoryProtocolError;
+export declare function invalidParameter(field: string, detail: string): MemoryProtocolError;
+export declare function versionConflict(id: string): MemoryProtocolError;
+export declare function storageError(detail: string): MemoryProtocolError;
+export declare function capabilityNotSupported(capability: string): MemoryProtocolError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,0BAA0B,CAAC;AAE/B,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,eAAe;gBAArB,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAE9D;AAED,wBAAgB,cAAc,IAAI,mBAAmB,CAEpD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAK/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAEnF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAE/D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAK9E"}

package/dist/errors.js

@@ -0,0 +1,31 @@
+// Error codes defined in MCP Memory Protocol Specification Section 7
+export class MemoryProtocolError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "MemoryProtocolError";
+    }
+}
+export function memoryNotFound(id) {
+    return new MemoryProtocolError("MEMORY_NOT_FOUND", `Memory entry with id='${id}' does not exist`);
+}
+export function invalidContent() {
+    return new MemoryProtocolError("INVALID_CONTENT", "content must be a non-empty string");
+}
+export function invalidLayer(value) {
+    return new MemoryProtocolError("INVALID_LAYER", `'${value}' is not a valid layer. Must be one of: episodic, semantic, procedural`);
+}
+export function invalidParameter(field, detail) {
+    return new MemoryProtocolError("INVALID_PARAMETER", `${field}: ${detail}`);
+}
+export function versionConflict(id) {
+    return new MemoryProtocolError("VERSION_CONFLICT", `Concurrent update conflict for id='${id}'`);
+}
+export function storageError(detail) {
+    return new MemoryProtocolError("STORAGE_ERROR", detail);
+}
+export function capabilityNotSupported(capability) {
+    return new MemoryProtocolError("CAPABILITY_NOT_SUPPORTED", `Capability '${capability}' is not supported by this server`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAWrE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAE1B;IADlB,YACkB,IAAqB,EACrC,OAAe;QAEf,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAHb,SAAI,GAAJ,IAAI,CAAiB;QAIrC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,oCAAoC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,IAAI,mBAAmB,CAC5B,eAAe,EACf,IAAI,KAAK,wEAAwE,CAClF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,MAAc;IAC5D,OAAO,IAAI,mBAAmB,CAAC,mBAAmB,EAAE,GAAG,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,sCAAsC,EAAE,GAAG,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,mBAAmB,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,IAAI,mBAAmB,CAC5B,0BAA0B,EAC1B,eAAe,UAAU,mCAAmC,CAC7D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { MemoryLayer, MemoryMetadata, MemoryStoreRequest, MemoryStoreResponse, RecallFilter, MemoryRecallRequest, RecalledMemory, MemoryRecallResponse, MemoryUpdateRequest, MemoryUpdateResponse, MemoryForgetRequest, MemoryForgetResponse, MemoryEntry, VersionInfo, MemoryProviderCapabilities, } from "./types.js";
+export type { MemoryProvider } from "./provider.js";
+export { MemoryProtocolError, memoryNotFound, invalidContent, invalidLayer, invalidParameter, versionConflict, storageError, capabilityNotSupported, } from "./errors.js";
+export type { MemoryErrorCode } from "./errors.js";
+export { MemoryLayerSchema, MemoryMetadataSchema, MemoryStoreRequestSchema, RecallFilterSchema, MemoryRecallRequestSchema, MemoryUpdateRequestSchema, MemoryForgetRequestSchema, } from "./schema.js";
+export { runConformanceSuite, runStoreTests, runRecallTests, runUpdateTests, runForgetTests, runVersioningTests, runErrorFormatTests, runCapabilitiesTests, } from "./conformance/index.js";
+export type { ConformanceTestContext, ConformanceResult, ConformanceSuiteOptions, } from "./conformance/index.js";
+//# 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":"AAAA,YAAY,EACV,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { MemoryProtocolError, memoryNotFound, invalidContent, invalidLayer, invalidParameter, versionConflict, storageError, capabilityNotSupported, } from "./errors.js";
+export { MemoryLayerSchema, MemoryMetadataSchema, MemoryStoreRequestSchema, RecallFilterSchema, MemoryRecallRequestSchema, MemoryUpdateRequestSchema, MemoryForgetRequestSchema, } from "./schema.js";
+export { runConformanceSuite, runStoreTests, runRecallTests, runUpdateTests, runForgetTests, runVersioningTests, runErrorFormatTests, runCapabilitiesTests, } from "./conformance/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryStoreRequest, MemoryStoreResponse, MemoryRecallRequest, MemoryRecallResponse, MemoryUpdateRequest, MemoryUpdateResponse, MemoryForgetRequest, MemoryForgetResponse, MemoryProviderCapabilities } from "./types.js";
+export interface MemoryProvider {
+    store(request: MemoryStoreRequest): Promise<MemoryStoreResponse>;
+    recall(request: MemoryRecallRequest): Promise<MemoryRecallResponse>;
+    update(request: MemoryUpdateRequest): Promise<MemoryUpdateResponse>;
+    forget(request: MemoryForgetRequest): Promise<MemoryForgetResponse>;
+    capabilities(): MemoryProviderCapabilities;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjE,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpE,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpE,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpE,YAAY,IAAI,0BAA0B,CAAC;CAC5C"}

package/dist/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":""}

package/dist/schema.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+export declare const MemoryLayerSchema: z.ZodEnum<{
+    episodic: "episodic";
+    semantic: "semantic";
+    procedural: "procedural";
+}>;
+export declare const MemoryMetadataSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$loose>;
+export declare const MemoryStoreRequestSchema: z.ZodObject<{
+    content: z.ZodString;
+    layer: z.ZodOptional<z.ZodEnum<{
+        episodic: "episodic";
+        semantic: "semantic";
+        procedural: "procedural";
+    }>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const RecallFilterSchema: z.ZodObject<{
+    layer: z.ZodOptional<z.ZodEnum<{
+        episodic: "episodic";
+        semantic: "semantic";
+        procedural: "procedural";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    createdAfter: z.ZodOptional<z.ZodString>;
+    createdBefore: z.ZodOptional<z.ZodString>;
+    memoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const MemoryRecallRequestSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodObject<{
+        layer: z.ZodOptional<z.ZodEnum<{
+            episodic: "episodic";
+            semantic: "semantic";
+            procedural: "procedural";
+        }>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        createdAfter: z.ZodOptional<z.ZodString>;
+        createdBefore: z.ZodOptional<z.ZodString>;
+        memoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    asOf: z.ZodOptional<z.ZodString>;
+    includeVersionHistory: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const MemoryUpdateRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        project: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        sessionId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        confidence: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    }, z.core.$loose>>;
+    createVersion: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const MemoryForgetRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    hard: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;EAAiD,CAAC;AAEhF,eAAO,MAAM,oBAAoB;;;;;iBAOjB,CAAC;AAEjB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;iBAMnC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;iBAMpC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;iBAOpC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export const MemoryLayerSchema = z.enum(["episodic", "semantic", "procedural"]);
+export const MemoryMetadataSchema = z
+    .object({
+    source: z.string().nullable().optional(),
+    project: z.string().nullable().optional(),
+    sessionId: z.string().nullable().optional(),
+    confidence: z.number().min(0).max(1).nullable().optional(),
+})
+    .passthrough();
+export const MemoryStoreRequestSchema = z.object({
+    content: z.string().min(1),
+    layer: MemoryLayerSchema.optional(),
+    metadata: MemoryMetadataSchema.optional(),
+    tags: z.array(z.string()).optional(),
+    ttl: z.number().int().positive().optional(),
+});
+export const RecallFilterSchema = z.object({
+    layer: MemoryLayerSchema.optional(),
+    tags: z.array(z.string()).optional(),
+    createdAfter: z.string().optional(),
+    createdBefore: z.string().optional(),
+    memoryIds: z.array(z.string()).optional(),
+});
+export const MemoryRecallRequestSchema = z.object({
+    query: z.string().optional(),
+    filter: RecallFilterSchema.optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    asOf: z.string().optional(),
+    includeVersionHistory: z.boolean().optional(),
+});
+export const MemoryUpdateRequestSchema = z.object({
+    id: z.string().min(1),
+    content: z.string().min(1).optional(),
+    summary: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    metadata: MemoryMetadataSchema.partial().optional(),
+    createVersion: z.boolean().optional(),
+});
+export const MemoryForgetRequestSchema = z.object({
+    id: z.string().min(1),
+    reason: z.string().optional(),
+    hard: z.boolean().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+export type MemoryLayer = "episodic" | "semantic" | "procedural";
+export interface MemoryMetadata {
+    source?: string | null;
+    project?: string | null;
+    sessionId?: string | null;
+    confidence?: number | null;
+    [key: string]: unknown;
+}
+export interface MemoryStoreRequest {
+    content: string;
+    layer?: MemoryLayer;
+    metadata?: MemoryMetadata;
+    tags?: string[];
+    ttl?: number;
+}
+export interface MemoryStoreResponse {
+    id: string;
+    layer: MemoryLayer;
+    version: number;
+    createdAt: string;
+}
+export interface RecallFilter {
+    layer?: MemoryLayer;
+    tags?: string[];
+    createdAfter?: string;
+    createdBefore?: string;
+    memoryIds?: string[];
+}
+export interface MemoryRecallRequest {
+    query?: string;
+    filter?: RecallFilter;
+    limit?: number;
+    asOf?: string;
+    includeVersionHistory?: boolean;
+}
+export interface RecalledMemory {
+    id: string;
+    content: string;
+    summary?: string;
+    layer: MemoryLayer;
+    version: number;
+    relevanceScore?: number;
+    accessCount: number;
+    tags: string[];
+    metadata?: MemoryMetadata;
+    createdAt: string;
+    updatedAt?: string;
+    lastAccessedAt?: string;
+}
+export interface MemoryRecallResponse {
+    memories: RecalledMemory[];
+    totalCount: number;
+    hasMore: boolean;
+}
+export interface MemoryUpdateRequest {
+    id: string;
+    content?: string;
+    summary?: string;
+    tags?: string[];
+    metadata?: Partial<MemoryMetadata>;
+    createVersion?: boolean;
+}
+export interface MemoryUpdateResponse {
+    id: string;
+    version: number;
+    previousVersion?: number;
+    updatedAt: string;
+}
+export interface MemoryForgetRequest {
+    id: string;
+    reason?: string;
+    hard?: boolean;
+}
+export interface MemoryForgetResponse {
+    id: string;
+    forgotten: boolean;
+    method: "soft" | "hard";
+}
+export interface MemoryEntry {
+    id: string;
+    layer: MemoryLayer;
+    content: string;
+    summary?: string | null;
+    accessCount: number;
+    lastAccessedAt?: string | null;
+    tags: string[];
+    metadata?: MemoryMetadata | null;
+    createdAt: string;
+    updatedAt?: string | null;
+    version: number;
+    supersedes?: string | null;
+    validFrom?: string | null;
+    deprecated: boolean;
+    deprecationReason?: string | null;
+}
+export interface VersionInfo {
+    version: number;
+    id: string;
+    supersedes?: string | null;
+    validFrom: string;
+    deprecated: boolean;
+    deprecationReason?: string | null;
+}
+export interface MemoryProviderCapabilities {
+    versioning: boolean;
+    semanticSearch: boolean;
+    layerPromotion: boolean;
+    temporalQuery: boolean;
+    ttl: boolean;
+    supportedLayers: MemoryLayer[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Protocol type definitions — MCP Memory Protocol Specification compliant
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0EAA0E"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@knowledgine/mcp-memory-protocol",
+  "version": "0.3.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "test": "vitest",
+    "test:run": "vitest run"
+  }
+}