mcp-memory-keeper 0.12.1 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.13.0] - 2026-06-05
11
+
12
+ ### Fixed
13
+
14
+ - Server-reported version is now read from `package.json` at runtime instead of a hardcoded string, which had drifted to `0.10.0`. Added an E2E test asserting the reported version matches `package.json` so it can't fall out of sync again.
15
+
16
+ ### Security
17
+
18
+ - **Arbitrary local file read via unvalidated `context_import` filePath** (#35)
19
+ - `context_import` passed the caller-supplied `filePath` straight to `fs.readFileSync`, with no path confinement. A malicious MCP client — or a prompt-injected agent — could point it at any file the server process could read: full contents for any JSON file (imported into the session, then retrievable via `context_get`/`context_export`), and the leading bytes of any other file (echoed back inside the `JSON.parse` error message)
20
+ - Imports are now confined to a server-owned exports directory (`<DATA_DIR>/exports`, overridable via `MEMORY_KEEPER_EXPORT_DIR`). Relative paths resolve against that directory; absolute paths are accepted only if they resolve — after following symlinks via `realpath` — to a location inside it. Traversal (`../`) and absolute paths outside the directory are rejected
21
+ - `context_export` now writes to that same exports directory (previously the OS temp dir), so the export → import round trip stays within the confined location
22
+ - Import failures no longer echo raw exception messages — at every stage (read, JSON parse, and the database write) a generic message is returned and the detail is logged server-side, so no file bytes or inserted values can leak back to the caller
23
+ - Import is hardened further: the resolved path must be a regular file (directories are rejected), capped at 50 MB and 100k entries to avoid memory/CPU exhaustion, and the whole import runs in a single transaction so a malformed row can never leave an orphaned or partially-populated session. Per-item and session-name shape are validated; `merge` only merges when a current session actually exists (and the result is reported honestly)
24
+ - The "not found" and "outside the exports directory" cases now return an identical generic message, removing a file-existence oracle, and the resolved absolute path is never echoed back to the caller
25
+ - `context_export`'s tool description and the import path resolution now guard the exports-directory startup (graceful FATAL on an unreadable directory)
26
+ - **Round-trip fidelity fixes** surfaced by review of the above: imported items now restore their `channel`, `is_private`, and `metadata` columns (previously dropped); file-cache rows with `NULL` content are preserved (previously dropped); a stored `size` of `0` is no longer wrongly recomputed; skipped-malformed counts and "checkpoints present but not imported" are reported instead of being silently lost; and `context_export` warns when a produced file is too large to be re-imported. The new current session is published only after the import transaction commits, so a failed import can no longer leave `currentSessionId` pointing at a rolled-back session
27
+ - Added an E2E security regression test suite that reproduces the issue #35 PoC (arbitrary JSON read, `/etc/passwd` byte leak, `..` traversal) and covers symlink escape, the `exports-dir`-prefix sibling boundary, the no-existence-oracle guarantee, empty/non-string paths, directory paths, valid-JSON-but-not-an-export, malformed-item skipping, and a data-preserving round trip
28
+ - Reported by Zhihao Zhang (@mcfly-zzh)
29
+
30
+ ## [0.12.2] - 2026-04-07
31
+
32
+ ### Fixed
33
+
34
+ - **`full` tool profile breaks OpenAI-compatible providers** (#33)
35
+ - `context_delegate.input.insights` array property was missing required `items` declaration
36
+ - Stricter providers rejected the schema with `invalid_function_parameters`
37
+ - Added `items: { type: 'object', properties: {...} }` to the `insights` property with proper `patterns`, `relationships`, `trends`, and `themes` fields
38
+ - Added `properties: {}` to `context_link.metadata` bare object schema for strict validator compatibility
39
+ - Added regression test that validates all array properties across all tool schemas have `items` declared
40
+ - Added comprehensive E2E test suite that spawns the actual MCP server and validates tool schemas, tool calls, and error handling over stdio
41
+
10
42
  ## [0.12.1] - 2026-03-24
11
43
 
12
44
  ### Fixed
@@ -507,7 +539,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
507
539
  - **Security**: Security updates
508
540
  - **Technical**: Internal improvements
509
541
 
510
- [Unreleased]: https://github.com/mkreyman/mcp-memory-keeper/compare/v0.12.1...HEAD
542
+ [Unreleased]: https://github.com/mkreyman/mcp-memory-keeper/compare/v0.12.2...HEAD
543
+ [0.12.2]: https://github.com/mkreyman/mcp-memory-keeper/compare/v0.12.1...v0.12.2
511
544
  [0.12.1]: https://github.com/mkreyman/mcp-memory-keeper/compare/v0.12.0...v0.12.1
512
545
  [0.12.0]: https://github.com/mkreyman/mcp-memory-keeper/compare/v0.11.0...v0.12.0
513
546
  [0.11.0]: https://github.com/mkreyman/mcp-memory-keeper/compare/v0.10.2...v0.11.0
package/README.md CHANGED
@@ -814,7 +814,8 @@ mcp_context_search({
814
814
  Share context or backup your work:
815
815
 
816
816
  ```javascript
817
- // Export current session
817
+ // Export current session — writes into the exports directory
818
+ // (<DATA_DIR>/exports/, overridable via MEMORY_KEEPER_EXPORT_DIR)
818
819
  mcp_context_export(); // Creates memory-keeper-export-xxx.json
819
820
 
820
821
  // Export specific session
@@ -823,7 +824,9 @@ mcp_context_export({
823
824
  format: 'json',
824
825
  });
825
826
 
826
- // Import from file
827
+ // Import from a file inside the exports directory.
828
+ // A bare filename resolves against that directory; the absolute path
829
+ // returned by context_export also works.
827
830
  mcp_context_import({
828
831
  filePath: 'memory-keeper-export-xxx.json',
829
832
  });
@@ -835,6 +838,17 @@ mcp_context_import({
835
838
  });
836
839
  ```
837
840
 
841
+ > **Security note:** For safety, `context_import` only reads files inside the
842
+ > server-owned exports directory (`<DATA_DIR>/exports/`, or
843
+ > `MEMORY_KEEPER_EXPORT_DIR` if set). Absolute paths outside that directory and
844
+ > `../` traversal are rejected, so the tool cannot be steered at arbitrary
845
+ > files on disk. Drop any file you want to import into that directory first.
846
+ > Point `MEMORY_KEEPER_EXPORT_DIR` at a dedicated directory — not at a home
847
+ > folder or a tree containing secrets — since any JSON file inside it becomes
848
+ > importable. (Prior to this change, exports were written to the OS temp
849
+ > directory; existing exports there must be moved into the exports directory to
850
+ > be re-imported.)
851
+
838
852
  ### Knowledge Graph (Phase 4)
839
853
 
840
854
  Automatically extract entities and relationships from your context:
@@ -0,0 +1,329 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ const globals_1 = require("@jest/globals");
37
+ const child_process_1 = require("child_process");
38
+ const fs = __importStar(require("fs"));
39
+ const path = __importStar(require("path"));
40
+ const os = __importStar(require("os"));
41
+ /**
42
+ * Security regression tests for GitHub issue #35:
43
+ * "Arbitrary Local File Read via Unvalidated context_import.filePath".
44
+ *
45
+ * Before the fix, context_import passed the caller-supplied filePath straight
46
+ * to fs.readFileSync, so an MCP client (or a prompt-injected agent) could read
47
+ * any file the server process could read — full contents for any JSON file, and
48
+ * the leading bytes of any other file (echoed back inside the JSON.parse error).
49
+ *
50
+ * These tests spawn the real server over stdio and assert that:
51
+ * 1. Absolute paths outside the exports directory are rejected.
52
+ * 2. `..` traversal is rejected.
53
+ * 3. Non-JSON system files (e.g. /etc/passwd) are rejected without leaking
54
+ * any of their bytes in the error message.
55
+ * 4. The secret in a rejected JSON file never becomes retrievable.
56
+ * 5. The legitimate export -> import round trip (inside the exports dir)
57
+ * still works.
58
+ *
59
+ * @see https://github.com/mkreyman/mcp-memory-keeper/issues/35
60
+ */
61
+ let serverProcess = null;
62
+ let serverInfo;
63
+ let tempDir;
64
+ let exportsDir;
65
+ let victimPath;
66
+ let msgId = 0;
67
+ let outputBuffer = '';
68
+ const SECRET = 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY';
69
+ const SECRET_KEY = 'AWS_SECRET_ACCESS_KEY';
70
+ function sendRequest(method, params = {}, timeoutMs = 5000) {
71
+ return new Promise((resolve, reject) => {
72
+ const id = ++msgId;
73
+ const timeout = setTimeout(() => {
74
+ reject(new Error(`Timeout waiting for response to ${method} (id=${id})`));
75
+ }, timeoutMs);
76
+ const onData = (data) => {
77
+ outputBuffer += data.toString();
78
+ const lines = outputBuffer.split('\n');
79
+ outputBuffer = lines.pop() || '';
80
+ for (const line of lines) {
81
+ if (!line.trim())
82
+ continue;
83
+ try {
84
+ const msg = JSON.parse(line);
85
+ if (msg.id === id) {
86
+ clearTimeout(timeout);
87
+ serverProcess?.stdout?.removeListener('data', onData);
88
+ resolve(msg);
89
+ }
90
+ }
91
+ catch {
92
+ // Not JSON, skip
93
+ }
94
+ }
95
+ };
96
+ serverProcess?.stdout?.on('data', onData);
97
+ serverProcess?.stdin?.write(JSON.stringify({ jsonrpc: '2.0', method, params, id }) + '\n');
98
+ });
99
+ }
100
+ function callTool(name, args) {
101
+ return sendRequest('tools/call', { name, arguments: args }).then(res => res.result?.content?.[0]?.text ?? JSON.stringify(res));
102
+ }
103
+ (0, globals_1.describe)('Security: context_import path confinement (issue #35)', () => {
104
+ (0, globals_1.beforeAll)(async () => {
105
+ tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-import-sec-'));
106
+ // Default exports dir is <DATA_DIR>/exports.
107
+ exportsDir = path.join(tempDir, 'exports');
108
+ // A "victim" JSON file OUTSIDE the exports directory (but inside the data
109
+ // dir) — proves confinement is to the exports dir, not just the data dir.
110
+ victimPath = path.join(tempDir, 'victim_export.json');
111
+ fs.writeFileSync(victimPath, JSON.stringify({
112
+ session: { name: 'victims-private-session', branch: 'main' },
113
+ contextItems: [
114
+ {
115
+ key: SECRET_KEY,
116
+ value: SECRET,
117
+ category: 'secret',
118
+ priority: 'high',
119
+ created_at: new Date(0).toISOString(),
120
+ },
121
+ ],
122
+ fileCache: [],
123
+ }));
124
+ serverProcess = (0, child_process_1.spawn)('node', [path.join(__dirname, '../../../dist/index.js')], {
125
+ env: { ...process.env, DATA_DIR: tempDir },
126
+ stdio: ['pipe', 'pipe', 'pipe'],
127
+ });
128
+ if (global.testProcesses) {
129
+ global.testProcesses.push(serverProcess);
130
+ }
131
+ const initResponse = await sendRequest('initialize', {
132
+ protocolVersion: '2024-11-05',
133
+ capabilities: {},
134
+ clientInfo: { name: 'import-sec-test', version: '1.0.0' },
135
+ });
136
+ (0, globals_1.expect)(initResponse.result).toHaveProperty('protocolVersion');
137
+ serverInfo = initResponse.result.serverInfo;
138
+ serverProcess?.stdin?.write(JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }) + '\n');
139
+ await new Promise(resolve => setTimeout(resolve, 200));
140
+ }, 10000);
141
+ (0, globals_1.afterAll)(async () => {
142
+ if (serverProcess && !serverProcess.killed) {
143
+ serverProcess.kill('SIGTERM');
144
+ await new Promise(resolve => {
145
+ const timeout = setTimeout(() => {
146
+ serverProcess?.kill('SIGKILL');
147
+ resolve();
148
+ }, 3000);
149
+ serverProcess?.on('exit', () => {
150
+ clearTimeout(timeout);
151
+ resolve();
152
+ });
153
+ });
154
+ serverProcess?.removeAllListeners();
155
+ }
156
+ serverProcess = null;
157
+ try {
158
+ fs.rmSync(tempDir, { recursive: true, force: true });
159
+ }
160
+ catch {
161
+ // ignore cleanup errors
162
+ }
163
+ });
164
+ (0, globals_1.it)('reports its version from package.json (no drift)', () => {
165
+ // The server version is read from package.json at runtime; this guards
166
+ // against the hardcoded value silently falling out of sync on a release.
167
+ const pkgVersion = require('../../../package.json').version;
168
+ (0, globals_1.expect)(serverInfo?.name).toBe('memory-keeper');
169
+ (0, globals_1.expect)(serverInfo?.version).toBe(pkgVersion);
170
+ });
171
+ (0, globals_1.it)('rejects an absolute path to a JSON file outside the exports directory', async () => {
172
+ const text = await callTool('context_import', { filePath: victimPath });
173
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
174
+ (0, globals_1.expect)(text).toMatch(/not found in the exports directory/i);
175
+ // The secret must never appear in the response.
176
+ (0, globals_1.expect)(text).not.toContain(SECRET);
177
+ });
178
+ (0, globals_1.it)('returns the same message for a missing path and an existing outside path (no existence oracle)', async () => {
179
+ // A file that exists outside the exports dir and a path that does not exist
180
+ // at all must be indistinguishable, so the error cannot be used to probe
181
+ // for the existence of arbitrary files on the host.
182
+ const missing = await callTool('context_import', { filePath: '/no/such/file/anywhere.json' });
183
+ const existsOutside = await callTool('context_import', { filePath: victimPath });
184
+ const strip = (t) => t.replace(/^Import failed:\s*/i, '').trim();
185
+ (0, globals_1.expect)(strip(existsOutside)).toBe(strip(missing));
186
+ // And neither echoes the resolved exports-directory absolute path.
187
+ (0, globals_1.expect)(existsOutside).not.toContain(exportsDir);
188
+ });
189
+ (0, globals_1.it)('does not make the rejected file’s secret retrievable via context_get', async () => {
190
+ const text = await callTool('context_get', { key: SECRET_KEY });
191
+ (0, globals_1.expect)(text).not.toContain(SECRET);
192
+ });
193
+ // Use an explicit conditional skip (not a bare `return`) so the platform gap
194
+ // is visible in the test report on systems without /etc/passwd.
195
+ const hasEtcPasswd = fs.existsSync('/etc/passwd');
196
+ (hasEtcPasswd ? globals_1.it : globals_1.it.skip)('rejects a non-JSON system file without leaking its bytes', async () => {
197
+ const text = await callTool('context_import', { filePath: '/etc/passwd' });
198
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
199
+ // The classic leak was "Unexpected token 'r', "root:x:0:0"...". Ensure no
200
+ // file bytes are reflected back.
201
+ (0, globals_1.expect)(text).not.toMatch(/root:/);
202
+ (0, globals_1.expect)(text).not.toMatch(/Unexpected token/);
203
+ });
204
+ (0, globals_1.it)('rejects `..` traversal out of the exports directory', async () => {
205
+ const text = await callTool('context_import', {
206
+ filePath: '../../../../../../etc/hostname',
207
+ });
208
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
209
+ (0, globals_1.expect)(text).not.toMatch(/Unexpected token/);
210
+ });
211
+ (0, globals_1.it)('rejects a symlink inside the exports dir that points outside it', async () => {
212
+ // realpathSync must resolve the symlink to its target before the
213
+ // confinement check, so an inside-the-dir symlink cannot escape.
214
+ const linkPath = path.join(exportsDir, 'escape.json');
215
+ try {
216
+ fs.symlinkSync(victimPath, linkPath);
217
+ }
218
+ catch (e) {
219
+ // Only treat a genuine platform restriction as "skip"; surface anything else.
220
+ const code = e.code;
221
+ if (code === 'EPERM' || code === 'ENOSYS' || code === 'EACCES') {
222
+ return;
223
+ }
224
+ throw e;
225
+ }
226
+ try {
227
+ const text = await callTool('context_import', { filePath: 'escape.json' });
228
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
229
+ (0, globals_1.expect)(text).toMatch(/not found in the exports directory/i);
230
+ (0, globals_1.expect)(text).not.toContain(SECRET);
231
+ }
232
+ finally {
233
+ fs.unlinkSync(linkPath);
234
+ }
235
+ });
236
+ (0, globals_1.it)('rejects a sibling directory whose name shares the exports-dir prefix', async () => {
237
+ // Guards the `startsWith(exportsDirReal + path.sep)` boundary: a sibling
238
+ // like "<exportsDir>-evil" must NOT be treated as inside the exports dir.
239
+ const evilDir = `${exportsDir}-evil`;
240
+ fs.mkdirSync(evilDir, { recursive: true });
241
+ const evilFile = path.join(evilDir, 'data.json');
242
+ fs.writeFileSync(evilFile, JSON.stringify({ session: { name: 'x' }, contextItems: [] }));
243
+ try {
244
+ const text = await callTool('context_import', { filePath: evilFile });
245
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
246
+ (0, globals_1.expect)(text).toMatch(/not found in the exports directory/i);
247
+ }
248
+ finally {
249
+ fs.rmSync(evilDir, { recursive: true, force: true });
250
+ }
251
+ });
252
+ (0, globals_1.it)('rejects an empty filePath', async () => {
253
+ const text = await callTool('context_import', { filePath: '' });
254
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
255
+ (0, globals_1.expect)(text).toMatch(/non-empty string/i);
256
+ });
257
+ (0, globals_1.it)('rejects a non-string filePath', async () => {
258
+ const text = await callTool('context_import', { filePath: 12345 });
259
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
260
+ (0, globals_1.expect)(text).toMatch(/non-empty string/i);
261
+ });
262
+ (0, globals_1.it)('rejects the exports directory itself (not a regular file)', async () => {
263
+ const text = await callTool('context_import', { filePath: exportsDir });
264
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
265
+ (0, globals_1.expect)(text).toMatch(/regular file/i);
266
+ });
267
+ (0, globals_1.it)('rejects a confined file that is valid JSON but not an export', async () => {
268
+ const notExport = path.join(exportsDir, 'not-an-export.json');
269
+ fs.writeFileSync(notExport, JSON.stringify({ hello: 'world' }));
270
+ try {
271
+ const text = await callTool('context_import', { filePath: 'not-an-export.json' });
272
+ (0, globals_1.expect)(text).toMatch(/Import failed/i);
273
+ (0, globals_1.expect)(text).toMatch(/not a valid memory-keeper export/i);
274
+ }
275
+ finally {
276
+ fs.rmSync(notExport, { force: true });
277
+ }
278
+ });
279
+ (0, globals_1.it)('still supports the legitimate export -> import round trip and preserves data', async () => {
280
+ // Seed a context item, export it (lands inside the exports dir), then
281
+ // import the produced file back.
282
+ await callTool('context_save', {
283
+ key: 'roundtrip_key',
284
+ value: 'roundtrip_value',
285
+ category: 'note',
286
+ });
287
+ const exportText = await callTool('context_export', { confirmEmpty: true });
288
+ // `.+?\.json` (with `.` not matching newlines) tolerates spaces in the
289
+ // path, unlike `\S+`.
290
+ const match = exportText.match(/to:\s*(.+?\.json)/);
291
+ (0, globals_1.expect)(match).toBeTruthy();
292
+ const exportPath = match[1];
293
+ // Export must write inside the exports directory.
294
+ (0, globals_1.expect)(exportPath.startsWith(exportsDir)).toBe(true);
295
+ const importText = await callTool('context_import', { filePath: exportPath });
296
+ (0, globals_1.expect)(importText).toMatch(/Import successful/i);
297
+ // A regression that silently dropped every item would still say "successful";
298
+ // assert at least one item was imported AND that the value is retrievable.
299
+ (0, globals_1.expect)(importText).toMatch(/Context items:\s*[1-9]/);
300
+ const getResult = await callTool('context_get', { key: 'roundtrip_key' });
301
+ (0, globals_1.expect)(getResult).toContain('roundtrip_value');
302
+ });
303
+ (0, globals_1.it)('skips malformed items but imports the valid ones and reports the skip count', async () => {
304
+ // A confined, well-formed export envelope with one good item and several
305
+ // malformed ones: the good item imports, the bad ones are skipped (not
306
+ // silently — the count is surfaced), and nothing aborts the transaction.
307
+ const mixed = path.join(exportsDir, 'mixed.json');
308
+ fs.writeFileSync(mixed, JSON.stringify({
309
+ session: { name: 'mixed', branch: 'main' },
310
+ contextItems: [
311
+ { key: 'good_key', value: 'good_value', category: 'note', priority: 'high' },
312
+ { key: 'no_value' }, // missing value -> skipped
313
+ { value: 'no_key' }, // missing key -> skipped
314
+ 'not-an-object', // not an object -> skipped
315
+ ],
316
+ fileCache: [],
317
+ }));
318
+ try {
319
+ const text = await callTool('context_import', { filePath: 'mixed.json' });
320
+ (0, globals_1.expect)(text).toMatch(/Import successful/i);
321
+ (0, globals_1.expect)(text).toMatch(/Context items:\s*1\s*\(skipped 3 malformed\)/);
322
+ const getResult = await callTool('context_get', { key: 'good_key' });
323
+ (0, globals_1.expect)(getResult).toContain('good_value');
324
+ }
325
+ finally {
326
+ fs.rmSync(mixed, { force: true });
327
+ }
328
+ });
329
+ });
@@ -0,0 +1,234 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ const globals_1 = require("@jest/globals");
37
+ const child_process_1 = require("child_process");
38
+ const fs = __importStar(require("fs"));
39
+ const path = __importStar(require("path"));
40
+ const os = __importStar(require("os"));
41
+ /**
42
+ * Issue #33 reproduction test.
43
+ *
44
+ * Reproduces the exact scenario reported: spawn the MCP server with each
45
+ * tool profile (minimal, standard, full), call tools/list, and validate
46
+ * that every returned tool schema passes strict JSON Schema validation
47
+ * that OpenAI-compatible providers enforce.
48
+ *
49
+ * The reporter found:
50
+ * - minimal: works
51
+ * - standard: works
52
+ * - full: fails (context_delegate.input.insights missing items)
53
+ *
54
+ * After the fix, all three profiles must pass.
55
+ *
56
+ * @see https://github.com/mkreyman/mcp-memory-keeper/issues/33
57
+ */
58
+ /**
59
+ * Strict schema validation matching what OpenAI-compatible providers enforce.
60
+ * Returns violation strings. Empty array = valid.
61
+ */
62
+ function strictValidateSchema(prop, path, toolName) {
63
+ const violations = [];
64
+ if (!prop.type) {
65
+ violations.push(`${toolName}: ${path} — missing 'type'`);
66
+ return violations;
67
+ }
68
+ // Arrays MUST have items (the exact bug from issue #33)
69
+ if (prop.type === 'array' && !prop.items) {
70
+ violations.push(`${toolName}: ${path} — array missing 'items' (issue #33)`);
71
+ }
72
+ // Enum values must match declared type
73
+ if (prop.enum && prop.type === 'string') {
74
+ for (const val of prop.enum) {
75
+ if (typeof val !== 'string') {
76
+ violations.push(`${toolName}: ${path} — enum value '${val}' is not a string`);
77
+ }
78
+ }
79
+ }
80
+ // Required fields must exist in properties
81
+ if (prop.type === 'object' && prop.required && prop.properties) {
82
+ for (const req of prop.required) {
83
+ if (!(req in prop.properties)) {
84
+ violations.push(`${toolName}: ${path} — required '${req}' not in properties`);
85
+ }
86
+ }
87
+ }
88
+ // Recurse into object properties
89
+ if (prop.type === 'object' && prop.properties) {
90
+ for (const [key, value] of Object.entries(prop.properties)) {
91
+ violations.push(...strictValidateSchema(value, `${path}.${key}`, toolName));
92
+ }
93
+ }
94
+ // Recurse into array items
95
+ if (prop.type === 'array' && prop.items && typeof prop.items === 'object') {
96
+ violations.push(...strictValidateSchema(prop.items, `${path}.items`, toolName));
97
+ }
98
+ return violations;
99
+ }
100
+ /**
101
+ * Spawn a server with a given TOOL_PROFILE, call tools/list, return the tools.
102
+ */
103
+ async function getToolsForProfile(profile) {
104
+ const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), `mcp-issue33-${profile}-`));
105
+ const proc = (0, child_process_1.spawn)('node', [path.join(__dirname, '../../../dist/index.js')], {
106
+ env: { ...process.env, DATA_DIR: tempDir, TOOL_PROFILE: profile },
107
+ stdio: ['pipe', 'pipe', 'pipe'],
108
+ });
109
+ if (global.testProcesses) {
110
+ global.testProcesses.push(proc);
111
+ }
112
+ let msgId = 0;
113
+ let outputBuffer = '';
114
+ const sendRequest = (method, params = {}) => {
115
+ return new Promise((resolve, reject) => {
116
+ const id = ++msgId;
117
+ const timeout = setTimeout(() => reject(new Error(`Timeout: ${method} on ${profile}`)), 10000);
118
+ const onData = (data) => {
119
+ outputBuffer += data.toString();
120
+ const lines = outputBuffer.split('\n');
121
+ outputBuffer = lines.pop() || '';
122
+ for (const line of lines) {
123
+ if (!line.trim())
124
+ continue;
125
+ try {
126
+ const msg = JSON.parse(line);
127
+ if (msg.id === id) {
128
+ clearTimeout(timeout);
129
+ proc.stdout?.removeListener('data', onData);
130
+ resolve(msg);
131
+ }
132
+ }
133
+ catch {
134
+ // skip
135
+ }
136
+ }
137
+ };
138
+ proc.stdout?.on('data', onData);
139
+ proc.stdin?.write(JSON.stringify({ jsonrpc: '2.0', method, params, id }) + '\n');
140
+ });
141
+ };
142
+ // Initialize
143
+ await sendRequest('initialize', {
144
+ protocolVersion: '2024-11-05',
145
+ capabilities: {},
146
+ clientInfo: { name: 'issue33-repro', version: '1.0.0' },
147
+ });
148
+ proc.stdin?.write(JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }) + '\n');
149
+ await new Promise(resolve => setTimeout(resolve, 200));
150
+ // Get tools
151
+ const response = await sendRequest('tools/list');
152
+ return { tools: response.result.tools, process: proc, tempDir };
153
+ }
154
+ const profiles = ['minimal', 'standard', 'full'];
155
+ const servers = [];
156
+ (0, globals_1.describe)('Issue #33 reproduction: all profiles must pass strict schema validation', () => {
157
+ (0, globals_1.afterAll)(async () => {
158
+ for (const server of servers) {
159
+ if (server.process && !server.process.killed) {
160
+ server.process.kill('SIGTERM');
161
+ await new Promise(resolve => {
162
+ const timeout = setTimeout(() => {
163
+ server.process?.kill('SIGKILL');
164
+ resolve();
165
+ }, 3000);
166
+ server.process?.on('exit', () => {
167
+ clearTimeout(timeout);
168
+ resolve();
169
+ });
170
+ });
171
+ server.process?.removeAllListeners();
172
+ }
173
+ try {
174
+ fs.rmSync(server.tempDir, { recursive: true, force: true });
175
+ }
176
+ catch {
177
+ // ignore
178
+ }
179
+ }
180
+ });
181
+ for (const profile of profiles) {
182
+ (0, globals_1.describe)(`TOOL_PROFILE=${profile}`, () => {
183
+ let tools;
184
+ beforeAll(async () => {
185
+ const result = await getToolsForProfile(profile);
186
+ tools = result.tools;
187
+ servers.push({ process: result.process, tempDir: result.tempDir });
188
+ }, 15000);
189
+ (0, globals_1.it)('should return tools', () => {
190
+ (0, globals_1.expect)(tools.length).toBeGreaterThan(0);
191
+ });
192
+ (0, globals_1.it)('all tool schemas should pass strict validation', () => {
193
+ const allViolations = [];
194
+ for (const tool of tools) {
195
+ allViolations.push(...strictValidateSchema(tool.inputSchema, 'inputSchema', tool.name));
196
+ }
197
+ if (allViolations.length > 0) {
198
+ throw new Error(`Profile "${profile}" has ${allViolations.length} schema violation(s):\n` +
199
+ allViolations.map(v => ` ${v}`).join('\n'));
200
+ }
201
+ });
202
+ (0, globals_1.it)('specifically: no array property should be missing items', () => {
203
+ const arrayViolations = [];
204
+ for (const tool of tools) {
205
+ arrayViolations.push(...strictValidateSchema(tool.inputSchema, 'inputSchema', tool.name).filter(v => v.includes('missing')));
206
+ }
207
+ (0, globals_1.expect)(arrayViolations).toHaveLength(0);
208
+ });
209
+ });
210
+ }
211
+ // The reporter specifically bisected these tools
212
+ (0, globals_1.describe)('reporter-flagged tools', () => {
213
+ let fullTools;
214
+ beforeAll(async () => {
215
+ const result = await getToolsForProfile('full');
216
+ fullTools = result.tools;
217
+ servers.push({ process: result.process, tempDir: result.tempDir });
218
+ }, 15000);
219
+ const flaggedTools = [
220
+ 'context_delegate',
221
+ 'context_find_related',
222
+ 'context_visualize',
223
+ 'context_branch_session',
224
+ ];
225
+ for (const toolName of flaggedTools) {
226
+ (0, globals_1.it)(`${toolName} should pass strict schema validation`, () => {
227
+ const tool = fullTools.find((t) => t.name === toolName);
228
+ (0, globals_1.expect)(tool).toBeDefined();
229
+ const violations = strictValidateSchema(tool.inputSchema, 'inputSchema', toolName);
230
+ (0, globals_1.expect)(violations).toHaveLength(0);
231
+ });
232
+ }
233
+ });
234
+ });