@novorb/mcp-core 2.1.1 → 3.0.0

package/dist/testing/isolated-dirs.js

@@ -0,0 +1,67 @@
+/**
+ * @novorb/mcp-core/testing - per-run temp directories so a server under test writes nothing into the
+ * developer's tree or profile.
+ */
+import { mkdirSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+function safeSegment(name) {
+    const safe = name.replace(/[^A-Za-z0-9._-]/g, '-').replace(/^\.+/, '');
+    if (!safe)
+        throw new Error(`createIsolatedDirs: invalid directory name "${name}"`);
+    return safe;
+}
+/** Create a fresh temp root under the OS temp dir with cwd, home, logs, state and tmp inside it. */
+export function createIsolatedDirs(prefix = 'mcp-it') {
+    const root = mkdtempSync(join(tmpdir(), `${safeSegment(prefix)}-`));
+    const make = (name) => {
+        const path = join(root, safeSegment(name));
+        mkdirSync(path, { recursive: true });
+        return path;
+    };
+    const cwd = make('cwd');
+    const home = make('home');
+    const logs = make('logs');
+    const state = make('state');
+    const tmp = make('tmp');
+    const appData = join(home, 'AppData', 'Roaming');
+    const localAppData = join(home, 'AppData', 'Local');
+    mkdirSync(appData, { recursive: true });
+    mkdirSync(localAppData, { recursive: true });
+    let removed = false;
+    return {
+        root,
+        cwd,
+        home,
+        logs,
+        state,
+        tmp,
+        dir: make,
+        env: () => ({
+            HOME: home,
+            USERPROFILE: home,
+            APPDATA: appData,
+            LOCALAPPDATA: localAppData,
+            XDG_CONFIG_HOME: join(home, '.config'),
+            XDG_CACHE_HOME: join(home, '.cache'),
+            XDG_DATA_HOME: join(home, '.local', 'share'),
+            XDG_STATE_HOME: join(home, '.local', 'state'),
+            TMPDIR: tmp,
+            TEMP: tmp,
+            TMP: tmp,
+            LOG_PATH: logs,
+        }),
+        cleanup: () => {
+            if (removed)
+                return;
+            try {
+                rmSync(root, { recursive: true, force: true, maxRetries: 10, retryDelay: 100 });
+                removed = true;
+            }
+            catch {
+                // A file still held open (Windows) must not fail the suite; the OS temp dir is reaped later.
+            }
+        },
+    };
+}
+//# sourceMappingURL=isolated-dirs.js.map

package/dist/testing/isolated-dirs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolated-dirs.js","sourceRoot":"","sources":["../../src/testing/isolated-dirs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAuBjC,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,GAAG,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,kBAAkB,CAAC,MAAM,GAAG,QAAQ;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,IAAI;QACJ,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,GAAG;QACH,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACV,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,YAAY;YAC1B,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;YACtC,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;YACpC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC;YAC5C,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC;YAC7C,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,GAAG;YACT,GAAG,EAAE,GAAG;YACR,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;gBAChF,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,6FAA6F;YAC/F,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/logs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @novorb/mcp-core/testing - read the logger's three files and scan text for leaked values.
+ */
+export interface LogFiles {
+    /** `<serverName>.log` (or the `mainFile` override): every entry at or above the level. */
+    main: string;
+    /** `exceptions.log`: ERROR entries only. */
+    exceptions: string;
+    /** `debug.log`: DEBUG entries only. */
+    debug: string;
+    /** Whether each file exists (a switched-off sink writes no file). */
+    exists: {
+        main: boolean;
+        exceptions: boolean;
+        debug: boolean;
+    };
+    /** Absolute path of each file. */
+    paths: {
+        main: string;
+        exceptions: string;
+        debug: string;
+    };
+}
+/** Same rule as the logger: the main file is `<name>.log` with the name sanitised to `[A-Za-z0-9._-]`. */
+export declare function logFileName(serverName: string): string;
+/**
+ * Read `<logDir>/<serverName>.log`, `exceptions.log` and `debug.log`. An absent file reads as ''.
+ * `mainFile` mirrors LOG_FILE: a bare name inside `logDir`, or an absolute path used as-is.
+ */
+export declare function readLogFiles(logDir: string, serverName: string, options?: {
+    mainFile?: string;
+}): LogFiles;
+/**
+ * The level of every non-empty line of a log file, in order: `DEBUG` / `INFO` / `WARN` / `ERROR`, or
+ * `UNKNOWN` for a line in neither format. Reads the text format (`<ISO> | INFO  | ...`) and the JSON
+ * format (`{"level":"INFO",...}`).
+ */
+export declare function logLevels(text: string): string[];
+/** Needles shorter than this are ignored by `findLeaks` (too likely to match by chance). */
+export declare const MIN_LEAK_NEEDLE_LENGTH = 6;
+export interface Leak {
+    /** Index of the needle in the `needles` array. */
+    index: number;
+    /** A masked preview: the first two characters, then `***`, then the length. Never the full value. */
+    preview: string;
+    /** Indexes of the texts the needle appears in. */
+    foundIn: number[];
+}
+/** Mask a value for a report: `ab***(len=12)`. */
+export declare function maskValue(value: string): string;
+/**
+ * Return every needle that appears verbatim in any text, as `{ index, preview, foundIn }` (never the
+ * value itself, so a failing assertion cannot print the secret). Needles that are empty or shorter than
+ * `minLength` (default {@link MIN_LEAK_NEEDLE_LENGTH}) are skipped, as are duplicates.
+ */
+export declare function findLeaks(texts: string[], needles: string[], options?: {
+    minLength?: number;
+}): Leak[];
+/** Collect every string value (recursively) from tool arguments, for use as `findLeaks` needles. */
+export declare function collectStrings(value: unknown, out?: string[]): string[];
+//# sourceMappingURL=logs.d.ts.map

package/dist/testing/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/testing/logs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,QAAQ;IACvB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,kCAAkC;IAClC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAItD;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,QAAQ,CAkB9G;AAID;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBhD;AAED,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,IAAI;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,EAAE,CAc1G;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAK3E"}

package/dist/testing/logs.js

@@ -0,0 +1,113 @@
+/**
+ * @novorb/mcp-core/testing - read the logger's three files and scan text for leaked values.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+/** Same rule as the logger: the main file is `<name>.log` with the name sanitised to `[A-Za-z0-9._-]`. */
+export function logFileName(serverName) {
+    const safe = serverName.replace(/[^A-Za-z0-9._-]/g, '-').replace(/^\.+/, '');
+    if (!safe)
+        throw new Error(`logFileName: "${serverName}" sanitises to an empty name`);
+    return `${safe}.log`;
+}
+function readOrEmpty(path) {
+    if (!existsSync(path))
+        return { text: '', exists: false };
+    return { text: readFileSync(path, 'utf8'), exists: true };
+}
+/**
+ * Read `<logDir>/<serverName>.log`, `exceptions.log` and `debug.log`. An absent file reads as ''.
+ * `mainFile` mirrors LOG_FILE: a bare name inside `logDir`, or an absolute path used as-is.
+ */
+export function readLogFiles(logDir, serverName, options = {}) {
+    const mainPath = options.mainFile !== undefined
+        ? isAbsolute(options.mainFile)
+            ? options.mainFile
+            : join(logDir, options.mainFile)
+        : join(logDir, logFileName(serverName));
+    const paths = { main: mainPath, exceptions: join(logDir, 'exceptions.log'), debug: join(logDir, 'debug.log') };
+    const main = readOrEmpty(paths.main);
+    const exceptions = readOrEmpty(paths.exceptions);
+    const debug = readOrEmpty(paths.debug);
+    return {
+        main: main.text,
+        exceptions: exceptions.text,
+        debug: debug.text,
+        exists: { main: main.exists, exceptions: exceptions.exists, debug: debug.exists },
+        paths,
+    };
+}
+const TEXT_LEVEL = /^\S+ \| (DEBUG|INFO|WARN|ERROR)\s* \|/;
+/**
+ * The level of every non-empty line of a log file, in order: `DEBUG` / `INFO` / `WARN` / `ERROR`, or
+ * `UNKNOWN` for a line in neither format. Reads the text format (`<ISO> | INFO  | ...`) and the JSON
+ * format (`{"level":"INFO",...}`).
+ */
+export function logLevels(text) {
+    const levels = [];
+    for (const line of text.split(/\r?\n/)) {
+        if (line.trim() === '')
+            continue;
+        const m = TEXT_LEVEL.exec(line);
+        if (m?.[1]) {
+            levels.push(m[1]);
+            continue;
+        }
+        let level = 'UNKNOWN';
+        if (line.startsWith('{')) {
+            try {
+                const parsed = JSON.parse(line);
+                const value = typeof parsed === 'object' && parsed !== null ? parsed.level : undefined;
+                if (typeof value === 'string')
+                    level = value;
+            }
+            catch {
+                // not JSON: UNKNOWN
+            }
+        }
+        levels.push(level);
+    }
+    return levels;
+}
+/** Needles shorter than this are ignored by `findLeaks` (too likely to match by chance). */
+export const MIN_LEAK_NEEDLE_LENGTH = 6;
+/** Mask a value for a report: `ab***(len=12)`. */
+export function maskValue(value) {
+    return `${value.slice(0, 2)}***(len=${value.length})`;
+}
+/**
+ * Return every needle that appears verbatim in any text, as `{ index, preview, foundIn }` (never the
+ * value itself, so a failing assertion cannot print the secret). Needles that are empty or shorter than
+ * `minLength` (default {@link MIN_LEAK_NEEDLE_LENGTH}) are skipped, as are duplicates.
+ */
+export function findLeaks(texts, needles, options = {}) {
+    const minLength = Math.max(1, options.minLength ?? MIN_LEAK_NEEDLE_LENGTH);
+    const seen = new Set();
+    const leaks = [];
+    needles.forEach((needle, index) => {
+        if (needle.length < minLength || seen.has(needle))
+            return;
+        seen.add(needle);
+        const foundIn = [];
+        texts.forEach((text, t) => {
+            if (text.includes(needle))
+                foundIn.push(t);
+        });
+        if (foundIn.length > 0)
+            leaks.push({ index, preview: maskValue(needle), foundIn });
+    });
+    return leaks;
+}
+/** Collect every string value (recursively) from tool arguments, for use as `findLeaks` needles. */
+export function collectStrings(value, out = []) {
+    if (typeof value === 'string')
+        out.push(value);
+    else if (Array.isArray(value))
+        for (const v of value)
+            collectStrings(v, out);
+    else if (typeof value === 'object' && value !== null)
+        for (const v of Object.values(value))
+            collectStrings(v, out);
+    return out;
+}
+//# sourceMappingURL=logs.js.map

package/dist/testing/logs.js.map

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

package/dist/testing/raw-http.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @novorb/mcp-core/testing - a minimal fetch wrapper for adverse HTTP checks (401, 404, 413, 415, ...).
+ */
+export interface RawHttpOptions {
+    /** HTTP method (default `POST`). */
+    method?: string;
+    headers?: Record<string, string>;
+    /** Request body (use `'x'.repeat(n)` for an oversized body). */
+    body?: string;
+    /** Abort after this many milliseconds (default 10000). */
+    timeoutMs?: number;
+}
+export interface RawHttpResponse {
+    status: number;
+    /** Response headers, names lower-cased. */
+    headers: Record<string, string>;
+    text: string;
+}
+/** Send one request and return status, headers and body text. Network errors throw. */
+export declare function rawHttp(url: string, options?: RawHttpOptions): Promise<RawHttpResponse>;
+/** A JSON-RPC `initialize` request body (2025-06-18), for raw requests that must reach the MCP handler. */
+export declare function initializeRequestBody(id?: number): string;
+/** Headers a Streamable HTTP POST needs (`content-type` + `accept`), plus an optional Bearer key. */
+export declare function mcpPostHeaders(apiKey?: string): Record<string, string>;
+//# sourceMappingURL=raw-http.d.ts.map

package/dist/testing/raw-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-http.d.ts","sourceRoot":"","sources":["../../src/testing/raw-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uFAAuF;AACvF,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAYjG;AAED,2GAA2G;AAC3G,wBAAgB,qBAAqB,CAAC,EAAE,SAAI,GAAG,MAAM,CAWpD;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtE"}

package/dist/testing/raw-http.js

@@ -0,0 +1,41 @@
+/**
+ * @novorb/mcp-core/testing - a minimal fetch wrapper for adverse HTTP checks (401, 404, 413, 415, ...).
+ */
+/** Send one request and return status, headers and body text. Network errors throw. */
+export async function rawHttp(url, options = {}) {
+    const res = await fetch(url, {
+        method: options.method ?? 'POST',
+        headers: options.headers,
+        body: options.body,
+        signal: AbortSignal.timeout(options.timeoutMs ?? 10_000),
+    });
+    const headers = {};
+    res.headers.forEach((value, key) => {
+        headers[key.toLowerCase()] = value;
+    });
+    return { status: res.status, headers, text: await res.text() };
+}
+/** A JSON-RPC `initialize` request body (2025-06-18), for raw requests that must reach the MCP handler. */
+export function initializeRequestBody(id = 1) {
+    return JSON.stringify({
+        jsonrpc: '2.0',
+        id,
+        method: 'initialize',
+        params: {
+            protocolVersion: '2025-06-18',
+            capabilities: {},
+            clientInfo: { name: 'mcp-core-testing-raw', version: '1.0.0' },
+        },
+    });
+}
+/** Headers a Streamable HTTP POST needs (`content-type` + `accept`), plus an optional Bearer key. */
+export function mcpPostHeaders(apiKey) {
+    const headers = {
+        'content-type': 'application/json',
+        accept: 'application/json, text/event-stream',
+    };
+    if (apiKey !== undefined)
+        headers.authorization = `Bearer ${apiKey}`;
+    return headers;
+}
+//# sourceMappingURL=raw-http.js.map

package/dist/testing/raw-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-http.js","sourceRoot":"","sources":["../../src/testing/raw-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,UAA0B,EAAE;IACrE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;KACzD,CAAC,CAAC;IACH,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;AACjE,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,qBAAqB,CAAC,EAAE,GAAG,CAAC;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE;YACN,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE;SAC/D;KACF,CAAC,CAAC;AACL,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,MAAM,EAAE,qCAAqC;KAC9C,CAAC;IACF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAC;IACrE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/testing/raw-peer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @novorb/mcp-core/testing - a raw JSON-RPC peer, for wire shapes the SDK client does not accept.
+ *
+ * The SDK 2.3.1 `Client` refuses a 2026-07-28 `tools/call` answered with `resultType: "task"`
+ * (typescript-sdk#2637; the requester side lives in `@modelcontextprotocol/ext-tasks`), so task tools
+ * are exercised on the modern era with plain JSON-RPC. `rawPeer` drives any SDK client transport
+ * (in memory, stdio); `rawHttpPeer` POSTs to a Streamable HTTP endpoint with the SEP-2243 headers.
+ * `modernMeta` builds the per-request 2026-07-28 envelope.
+ */
+import { type Transport } from '@modelcontextprotocol/client';
+export declare const MODERN_PROTOCOL_VERSION = "2026-07-28";
+/** The `_meta` envelope of a 2026-07-28 request. */
+export declare function modernMeta(capabilities?: Record<string, unknown>): Record<string, unknown>;
+/** A JSON-RPC response as received. */
+export interface RawResponse {
+    result?: Record<string, unknown>;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface RawPeer {
+    /** Send a request and resolve with its response (notifications before it are collected). */
+    request(method: string, params?: Record<string, unknown>, options?: {
+        timeoutMs?: number;
+    }): Promise<RawResponse>;
+    /** Send a notification. */
+    notify(method: string, params?: Record<string, unknown>): Promise<void>;
+    /** Every notification received so far. */
+    notifications: Array<{
+        method: string;
+        params?: Record<string, unknown>;
+    }>;
+    close(): Promise<void>;
+}
+/** Drive an SDK client transport (started here) with raw JSON-RPC. */
+export declare function rawPeer(transport: Transport): Promise<RawPeer>;
+/** The last JSON-RPC message of a JSON or SSE body. */
+export declare function parseRpcBody(contentType: string | null, text: string): RawResponse;
+/** POST one 2026-07-28 request per call to `url` (an MCP endpoint), with an optional Bearer key. */
+export declare function rawHttpPeer(url: string, apiKey?: string): Pick<RawPeer, 'request'>;
+//# sourceMappingURL=raw-peer.d.ts.map

package/dist/testing/raw-peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-peer.d.ts","sourceRoot":"","sources":["../../src/testing/raw-peer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9F;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,OAAO;IACtB,4FAA4F;IAC5F,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClH,2BAA2B;IAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,0CAA0C;IAC1C,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,sEAAsE;AACtE,wBAAsB,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCpE;AAeD,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAUlF;AAED,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAelF"}

package/dist/testing/raw-peer.js

@@ -0,0 +1,101 @@
+/**
+ * @novorb/mcp-core/testing - a raw JSON-RPC peer, for wire shapes the SDK client does not accept.
+ *
+ * The SDK 2.3.1 `Client` refuses a 2026-07-28 `tools/call` answered with `resultType: "task"`
+ * (typescript-sdk#2637; the requester side lives in `@modelcontextprotocol/ext-tasks`), so task tools
+ * are exercised on the modern era with plain JSON-RPC. `rawPeer` drives any SDK client transport
+ * (in memory, stdio); `rawHttpPeer` POSTs to a Streamable HTTP endpoint with the SEP-2243 headers.
+ * `modernMeta` builds the per-request 2026-07-28 envelope.
+ */
+import { CLIENT_CAPABILITIES_META_KEY, CLIENT_INFO_META_KEY, PROTOCOL_VERSION_META_KEY, } from '@modelcontextprotocol/client';
+export const MODERN_PROTOCOL_VERSION = '2026-07-28';
+/** The `_meta` envelope of a 2026-07-28 request. */
+export function modernMeta(capabilities = {}) {
+    return {
+        [PROTOCOL_VERSION_META_KEY]: MODERN_PROTOCOL_VERSION,
+        [CLIENT_INFO_META_KEY]: { name: 'mcp-core-raw-peer', version: '1.0.0' },
+        [CLIENT_CAPABILITIES_META_KEY]: capabilities,
+    };
+}
+/** Drive an SDK client transport (started here) with raw JSON-RPC. */
+export async function rawPeer(transport) {
+    let nextId = 1;
+    const pending = new Map();
+    const notifications = [];
+    transport.onmessage = (message) => {
+        const m = message;
+        if (m.method !== undefined && m.id === undefined) {
+            notifications.push({ method: m.method, ...(m.params ? { params: m.params } : {}) });
+            return;
+        }
+        if (m.id !== undefined && m.method === undefined) {
+            const resolve = pending.get(m.id);
+            pending.delete(m.id);
+            resolve?.({ ...(m.result ? { result: m.result } : {}), ...(m.error ? { error: m.error } : {}) });
+        }
+    };
+    await transport.start();
+    return {
+        notifications,
+        request: (method, params, options) => {
+            const id = nextId++;
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    pending.delete(id);
+                    reject(new Error(`raw peer: no response to ${method} within ${options?.timeoutMs ?? 10_000} ms`));
+                }, options?.timeoutMs ?? 10_000);
+                pending.set(id, (response) => {
+                    clearTimeout(timer);
+                    resolve(response);
+                });
+                transport.send({ jsonrpc: '2.0', id, method, ...(params ? { params } : {}) }).catch(reject);
+            });
+        },
+        notify: (method, params) => transport.send({ jsonrpc: '2.0', method, ...(params ? { params } : {}) }),
+        close: () => transport.close(),
+    };
+}
+/** Headers SEP-2243 requires on a 2026-07-28 POST (`Mcp-Name` for tools/call and tasks/*). */
+function modernHeaders(method, params) {
+    const headers = {
+        'content-type': 'application/json',
+        accept: 'application/json, text/event-stream',
+        'mcp-protocol-version': MODERN_PROTOCOL_VERSION,
+        'mcp-method': method,
+    };
+    const name = method === 'tools/call' ? params?.name : method.startsWith('tasks/') ? params?.taskId : undefined;
+    if (typeof name === 'string')
+        headers['mcp-name'] = name;
+    return headers;
+}
+/** The last JSON-RPC message of a JSON or SSE body. */
+export function parseRpcBody(contentType, text) {
+    const payload = contentType?.includes('text/event-stream')
+        ? text
+            .split('\n')
+            .filter((line) => line.startsWith('data:'))
+            .map((line) => line.slice(5).trim())
+            .filter((line) => line.includes('"id"'))
+            .at(-1)
+        : text;
+    return JSON.parse(payload ?? '{}');
+}
+/** POST one 2026-07-28 request per call to `url` (an MCP endpoint), with an optional Bearer key. */
+export function rawHttpPeer(url, apiKey) {
+    let nextId = 1;
+    return {
+        async request(method, params, options) {
+            const headers = modernHeaders(method, params);
+            if (apiKey !== undefined)
+                headers.authorization = `Bearer ${apiKey}`;
+            const res = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ jsonrpc: '2.0', id: nextId++, method, ...(params ? { params } : {}) }),
+                signal: AbortSignal.timeout(options?.timeoutMs ?? 10_000),
+            });
+            return parseRpcBody(res.headers.get('content-type'), await res.text());
+        },
+    };
+}
+//# sourceMappingURL=raw-peer.js.map

package/dist/testing/raw-peer.js.map

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

package/dist/testing/recording-server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @novorb/mcp-core/testing - a minimal stand-in for McpServer that records registered tools and
+ * prompts, so unit tests can invoke their handlers directly without the MCP protocol.
+ *
+ * Behaviour (unchanged from the per-server copies it replaces): `registerTool` / `registerPrompt` store
+ * `{ name, config, handler }` under the name (a later registration with the same name replaces the
+ * earlier one) and return a handle whose `remove()` deletes it. Nothing is validated and nothing else
+ * of McpServer is implemented.
+ */
+import type { ClientCapabilities, GetPromptResult } from '@modelcontextprotocol/server';
+import type { McpCallToolResult, McpServer } from '../server.js';
+/** Handler signature as recorded; call it with the tool arguments (and optionally a request extra). */
+export type RecordedToolHandler = (args: Record<string, unknown>, extra?: unknown) => Promise<McpCallToolResult>;
+export type RecordedPromptHandler = (args: Record<string, unknown>, extra?: unknown) => GetPromptResult | Promise<GetPromptResult>;
+/** The tool/prompt config as passed to register*: description, schemas, annotations, ... */
+export type RecordedConfig = Record<string, unknown>;
+export interface CapturedTool {
+    name: string;
+    config: RecordedConfig;
+    handler: RecordedToolHandler;
+}
+export interface CapturedPrompt {
+    name: string;
+    config: RecordedConfig;
+    handler: RecordedPromptHandler;
+}
+export interface RecordingServer {
+    tools: Map<string, CapturedTool>;
+    prompts: Map<string, CapturedPrompt>;
+    /** Cast to McpServer for passing into register* functions. */
+    asMcpServer(): McpServer;
+}
+export interface RecordingServerOptions {
+    /** What `server.getClientCapabilities()` answers (the `ToolContext` client input helpers read it). */
+    clientCapabilities?: ClientCapabilities;
+}
+export declare function makeRecordingServer(options?: RecordingServerOptions): RecordingServer;
+//# sourceMappingURL=recording-server.d.ts.map

package/dist/testing/recording-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-server.d.ts","sourceRoot":"","sources":["../../src/testing/recording-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEjE,uGAAuG;AACvG,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AACjH,MAAM,MAAM,qBAAqB,GAAG,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,CAAC,EAAE,OAAO,KACZ,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD,4FAA4F;AAC5F,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,8DAA8D;IAC9D,WAAW,IAAI,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,sGAAsG;IACtG,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CA6BzF"}

package/dist/testing/recording-server.js

@@ -0,0 +1,38 @@
+/**
+ * @novorb/mcp-core/testing - a minimal stand-in for McpServer that records registered tools and
+ * prompts, so unit tests can invoke their handlers directly without the MCP protocol.
+ *
+ * Behaviour (unchanged from the per-server copies it replaces): `registerTool` / `registerPrompt` store
+ * `{ name, config, handler }` under the name (a later registration with the same name replaces the
+ * earlier one) and return a handle whose `remove()` deletes it. Nothing is validated and nothing else
+ * of McpServer is implemented.
+ */
+export function makeRecordingServer(options = {}) {
+    const tools = new Map();
+    const prompts = new Map();
+    const server = {
+        server: { getClientCapabilities: () => options.clientCapabilities },
+        registerTool(name, config, handler) {
+            tools.set(name, { name, config, handler });
+            return {
+                remove() {
+                    tools.delete(name);
+                },
+            };
+        },
+        registerPrompt(name, config, handler) {
+            prompts.set(name, { name, config, handler });
+            return {
+                remove() {
+                    prompts.delete(name);
+                },
+            };
+        },
+    };
+    return {
+        tools,
+        prompts,
+        asMcpServer: () => server,
+    };
+}
+//# sourceMappingURL=recording-server.js.map

package/dist/testing/recording-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-server.js","sourceRoot":"","sources":["../../src/testing/recording-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuCH,MAAM,UAAU,mBAAmB,CAAC,UAAkC,EAAE;IACtE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,EAAE,qBAAqB,EAAE,GAAmC,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE;QACnG,YAAY,CAAC,IAAY,EAAE,MAAsB,EAAE,OAA4B;YAC7E,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3C,OAAO;gBACL,MAAM;oBACJ,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;aACF,CAAC;QACJ,CAAC;QACD,cAAc,CAAC,IAAY,EAAE,MAAsB,EAAE,OAA8B;YACjF,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO;gBACL,MAAM;oBACJ,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,KAAK;QACL,OAAO;QACP,WAAW,EAAE,GAAG,EAAE,CAAC,MAA8B;KAClD,CAAC;AACJ,CAAC"}