@novorb/mcp-core 2.1.1 → 3.0.0

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

@@ -0,0 +1,76 @@
+/**
+ * @novorb/mcp-core/testing - start a BUILT MCP server as a child process and connect a v2 client.
+ *
+ * stdio: the SDK `StdioClientTransport` spawns `node <entry>` and speaks over its stdin/stdout.
+ * http:  the harness spawns `node <entry>` with MCP_TRANSPORT=http on a free loopback port, polls
+ *        `GET /health` until it answers 200, then connects `StreamableHTTPClientTransport` with the
+ *        Bearer header.
+ *
+ * The child env is EXPLICIT: the minimal OS variables node needs (the SDK's DEFAULT_INHERITED_ENV_VARS
+ * list), the caller's `env`, and the harness variables. The parent's own environment (a developer's
+ * secrets, a dotenv-loaded `.env`) never reaches the child unless `inheritEnv: true`.
+ */
+import { type ChildProcess } from 'node:child_process';
+import type { Client } from '@modelcontextprotocol/client';
+import { type TestClientOptions } from './client.js';
+export type HarnessMode = 'stdio' | 'http';
+export interface StartBuiltServerOptions extends TestClientOptions {
+    /** Path of the server entry, e.g. `<repo>/dist/index.js`. Run as `node [nodeArgs] <entry>`. */
+    entry: string;
+    /** Transport to start the server in. */
+    mode: HarnessMode;
+    /** Variables for the child. Merged over the minimal OS set; the harness variables win over these. */
+    env?: Record<string, string>;
+    /** Working directory of the child (default: the parent's cwd). Use an isolated temp dir in tests. */
+    cwd?: string;
+    /**
+     * http only: the Bearer key. A string sets MCP_API_KEY to it; `null` starts the server open
+     * (MCP_AUTH_DISABLED=true, no Authorization header). Omitted: `env.MCP_API_KEY` when given, else a
+     * random 32-byte hex key.
+     */
+    apiKey?: string | null;
+    /** How long to wait for readiness: http `/health` polling and the client connect (default 20000). */
+    readyTimeoutMs?: number;
+    /** Pass the parent's full environment through (default false: explicit env only). */
+    inheritEnv?: boolean;
+    /** Extra node arguments before the entry, e.g. `['--import', 'tsx']` to run a `.ts` entry. */
+    nodeArgs?: string[];
+    /** http only: the listen port (default: a free loopback port). */
+    port?: number;
+    /**
+     * Sets MCP_ENV_FILE for the child: the env-file override honoured by a server that loads its env
+     * through mcp-core's env loader (point it at an empty file, or at the loader's documented "none"
+     * value, so a developer `.env` cannot fill gaps). Equivalent to `env.MCP_ENV_FILE`; this wins.
+     */
+    envFile?: string;
+}
+export interface BuiltServer {
+    /** A connected v2 client. */
+    client: Client;
+    mode: HarnessMode;
+    /** http only: the `/mcp` endpoint URL. */
+    url?: string;
+    /** http only: the server base URL (`http://127.0.0.1:<port>`), for `/health` and raw requests. */
+    baseUrl?: string;
+    /** http only: the Bearer key in use (undefined when started open). Never log it. */
+    apiKey?: string;
+    /** The exact environment the child was started with (useful as `findLeaks` needles). */
+    env: Readonly<Record<string, string>>;
+    /** The child pid, when known. */
+    pid?: number;
+    /** Everything the child wrote to stderr so far. */
+    stderr(): string;
+    /** http only: everything the child wrote to stdout so far (stdio mode: always ''). */
+    stdout(): string;
+    /** Close the client and kill the child, awaiting its exit. Idempotent; never throws. */
+    stop(): Promise<void>;
+}
+/** The minimal OS variables node needs to run, read from the parent (only those that are set). */
+export declare function minimalOsEnv(source?: NodeJS.ProcessEnv): Record<string, string>;
+/** A free TCP port on 127.0.0.1 (bound and released; a small reuse race is possible but rare). */
+export declare function freePort(): Promise<number>;
+/** Kill a child and await its exit (SIGTERM, then SIGKILL after a grace period). Windows-safe. */
+export declare function killAndWait(child: ChildProcess, graceMs?: number): Promise<void>;
+/** Start a built server in stdio or http mode and return a connected v2 client plus teardown. */
+export declare function startBuiltServer(options: StartBuiltServerOptions): Promise<BuiltServer>;
+//# sourceMappingURL=server-process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-process.d.ts","sourceRoot":"","sources":["../../src/testing/server-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,qGAAqG;IACrG,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qGAAqG;IACrG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtC,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,IAAI,MAAM,CAAC;IACjB,sFAAsF;IACtF,MAAM,IAAI,MAAM,CAAC;IACjB,wFAAwF;IACxF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,MAAM,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO5F;AAQD,kGAAkG;AAClG,wBAAgB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAU1C;AAcD,kGAAkG;AAClG,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW7F;AAmDD,iGAAiG;AACjG,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAU7F"}

package/dist/testing/server-process.js

@@ -0,0 +1,241 @@
+/**
+ * @novorb/mcp-core/testing - start a BUILT MCP server as a child process and connect a v2 client.
+ *
+ * stdio: the SDK `StdioClientTransport` spawns `node <entry>` and speaks over its stdin/stdout.
+ * http:  the harness spawns `node <entry>` with MCP_TRANSPORT=http on a free loopback port, polls
+ *        `GET /health` until it answers 200, then connects `StreamableHTTPClientTransport` with the
+ *        Bearer header.
+ *
+ * The child env is EXPLICIT: the minimal OS variables node needs (the SDK's DEFAULT_INHERITED_ENV_VARS
+ * list), the caller's `env`, and the harness variables. The parent's own environment (a developer's
+ * secrets, a dotenv-loaded `.env`) never reaches the child unless `inheritEnv: true`.
+ */
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { createServer as createNetServer } from 'node:net';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/client';
+import { DEFAULT_INHERITED_ENV_VARS, StdioClientTransport } from '@modelcontextprotocol/client/stdio';
+import { createTestClient } from './client.js';
+const DEFAULT_READY_TIMEOUT_MS = 20_000;
+const POLL_INTERVAL_MS = 50;
+const EXIT_GRACE_MS = 5_000;
+/** The minimal OS variables node needs to run, read from the parent (only those that are set). */
+export function minimalOsEnv(source = process.env) {
+    const out = {};
+    for (const key of DEFAULT_INHERITED_ENV_VARS) {
+        const value = source[key];
+        if (value !== undefined && !value.startsWith('()'))
+            out[key] = value;
+    }
+    return out;
+}
+function stringEnv(source) {
+    const out = {};
+    for (const [k, v] of Object.entries(source))
+        if (v !== undefined)
+            out[k] = v;
+    return out;
+}
+/** A free TCP port on 127.0.0.1 (bound and released; a small reuse race is possible but rare). */
+export function freePort() {
+    return new Promise((ok, fail) => {
+        const srv = createNetServer();
+        srv.once('error', fail);
+        srv.listen(0, '127.0.0.1', () => {
+            const addr = srv.address();
+            const port = typeof addr === 'object' && addr ? addr.port : 0;
+            srv.close(() => (port > 0 ? ok(port) : fail(new Error('freePort: no port assigned'))));
+        });
+    });
+}
+function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function tail(text, max = 4000) {
+    return text.length > max ? `...${text.slice(-max)}` : text;
+}
+function hasExited(child) {
+    return child.exitCode !== null || child.signalCode !== null;
+}
+/** Kill a child and await its exit (SIGTERM, then SIGKILL after a grace period). Windows-safe. */
+export async function killAndWait(child, graceMs = EXIT_GRACE_MS) {
+    if (hasExited(child))
+        return;
+    const exited = new Promise((done) => child.once('exit', () => done()));
+    // On Windows `kill()` maps to TerminateProcess regardless of the signal; on POSIX SIGTERM lets the
+    // server's own shutdown path run first.
+    child.kill('SIGTERM');
+    const timer = new Promise((r) => setTimeout(() => r('timeout'), graceMs).unref());
+    if ((await Promise.race([exited.then(() => 'exited'), timer])) === 'timeout' && !hasExited(child)) {
+        child.kill('SIGKILL');
+        await exited;
+    }
+}
+async function waitForHealth(baseUrl, child, timeoutMs, stderr) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError = 'no response';
+    while (Date.now() < deadline) {
+        if (hasExited(child)) {
+            throw new Error(`startBuiltServer: server exited (code ${child.exitCode ?? child.signalCode}) before /health was ready.\n` +
+                `stderr:\n${tail(stderr())}`);
+        }
+        try {
+            const res = await fetch(`${baseUrl}/health`, { signal: AbortSignal.timeout(1_000) });
+            if (res.status === 200)
+                return;
+            lastError = `status ${res.status}`;
+        }
+        catch (e) {
+            lastError = e instanceof Error ? e.message : String(e);
+        }
+        await delay(POLL_INTERVAL_MS);
+    }
+    throw new Error(`startBuiltServer: /health not ready within ${timeoutMs} ms (${lastError}).\nstderr:\n${tail(stderr())}`);
+}
+async function withTimeout(promise, ms, what) {
+    let timer;
+    const timeout = new Promise((_, fail) => {
+        timer = setTimeout(() => fail(new Error(`${what} timed out after ${ms} ms`)), ms);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+function once(fn) {
+    let pending;
+    return () => {
+        pending ??= fn();
+        return pending;
+    };
+}
+/** Start a built server in stdio or http mode and return a connected v2 client plus teardown. */
+export async function startBuiltServer(options) {
+    const readyTimeoutMs = options.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
+    const base = options.inheritEnv ? stringEnv(process.env) : minimalOsEnv();
+    const callerEnv = { ...options.env };
+    if (options.envFile !== undefined)
+        callerEnv.MCP_ENV_FILE = options.envFile;
+    const opts = { ...options, env: callerEnv };
+    const args = [...(options.nodeArgs ?? []), options.entry];
+    return options.mode === 'stdio'
+        ? startStdio(opts, { ...base, ...callerEnv, MCP_TRANSPORT: 'stdio' }, args, readyTimeoutMs)
+        : startHttp(opts, base, args, readyTimeoutMs);
+}
+async function startStdio(options, env, args, readyTimeoutMs) {
+    let stderrText = '';
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args,
+        env,
+        cwd: options.cwd,
+        stderr: 'pipe',
+    });
+    transport.stderr?.on('data', (chunk) => {
+        stderrText += chunk.toString();
+    });
+    const client = createTestClient(options);
+    const stop = once(async () => {
+        // client.close() closes the transport, which ends stdin, then SIGTERM, then SIGKILL, awaiting exit.
+        await client.close().catch(() => undefined);
+        await transport.close().catch(() => undefined);
+    });
+    try {
+        await withTimeout(client.connect(transport), readyTimeoutMs, 'startBuiltServer: stdio connect');
+    }
+    catch (e) {
+        await stop();
+        const message = e instanceof Error ? e.message : String(e);
+        throw new Error(`startBuiltServer: stdio connect failed: ${message}\nstderr:\n${tail(stderrText)}`);
+    }
+    return {
+        client,
+        mode: 'stdio',
+        env,
+        pid: transport.pid ?? undefined,
+        stderr: () => stderrText,
+        stdout: () => '',
+        stop,
+    };
+}
+function resolveApiKey(options) {
+    if (options.apiKey === null)
+        return undefined;
+    if (typeof options.apiKey === 'string')
+        return options.apiKey;
+    return options.env?.MCP_API_KEY || randomBytes(32).toString('hex');
+}
+async function startHttp(options, base, args, readyTimeoutMs) {
+    const port = options.port ?? (await freePort());
+    const apiKey = resolveApiKey(options);
+    const env = {
+        ...base,
+        ...options.env,
+        MCP_TRANSPORT: 'http',
+        MCP_HTTP_HOST: '127.0.0.1',
+        PORT: String(port),
+    };
+    if (apiKey === undefined) {
+        delete env.MCP_API_KEY;
+        env.MCP_AUTH_DISABLED = 'true';
+    }
+    else {
+        env.MCP_API_KEY = apiKey;
+    }
+    const child = spawn(process.execPath, args, {
+        env,
+        cwd: options.cwd,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: false,
+        windowsHide: true,
+    });
+    let stderrText = '';
+    let stdoutText = '';
+    child.stderr?.on('data', (chunk) => {
+        stderrText += chunk.toString();
+    });
+    child.stdout?.on('data', (chunk) => {
+        stdoutText += chunk.toString();
+    });
+    const spawnError = new Promise((_, fail) => {
+        child.once('error', (err) => fail(new Error(`startBuiltServer: spawn failed: ${err.message}`)));
+    });
+    spawnError.catch(() => undefined);
+    const baseUrl = `http://127.0.0.1:${port}`;
+    const url = `${baseUrl}/mcp`;
+    const client = createTestClient(options);
+    let connected = false;
+    const stop = once(async () => {
+        if (connected)
+            await client.close().catch(() => undefined);
+        await killAndWait(child);
+    });
+    try {
+        await Promise.race([waitForHealth(baseUrl, child, readyTimeoutMs, () => stderrText), spawnError]);
+        const transport = new StreamableHTTPClientTransport(new URL(url), apiKey === undefined ? {} : { requestInit: { headers: { Authorization: `Bearer ${apiKey}` } } });
+        await withTimeout(client.connect(transport), readyTimeoutMs, 'startBuiltServer: http connect');
+        connected = true;
+    }
+    catch (e) {
+        await stop();
+        throw e instanceof Error && e.message.startsWith('startBuiltServer:')
+            ? e
+            : new Error(`startBuiltServer: http connect failed: ${e instanceof Error ? e.message : String(e)}\nstderr:\n${tail(stderrText)}`);
+    }
+    return {
+        client,
+        mode: 'http',
+        url,
+        baseUrl,
+        apiKey,
+        env,
+        pid: child.pid,
+        stderr: () => stderrText,
+        stdout: () => stdoutText,
+        stop,
+    };
+}
+//# sourceMappingURL=server-process.js.map

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

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

package/dist/testing/tools.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @novorb/mcp-core/testing - tool call and tool coverage helpers over a connected v2 client.
+ */
+import type { CallToolResult, Client } from '@modelcontextprotocol/client';
+export interface ToolJsonResult<T = unknown> {
+    /** `result.isError === true`. */
+    isError: boolean;
+    /**
+     * `structuredContent` when the tool returned it; otherwise the first text block parsed as JSON, or the
+     * raw text when it is not JSON; `undefined` when there is neither.
+     */
+    body: T;
+    /** The first text block ('' when there is none). */
+    text: string;
+    /** The unmodified SDK result. */
+    raw: CallToolResult;
+}
+/**
+ * Call a tool and decode its body. Tool-level failures come back as `isError: true` (not a throw);
+ * protocol errors (unknown tool, schema rejection on some servers) throw from the SDK as usual.
+ */
+export declare function callToolJson<T = unknown>(client: Client, name: string, args?: Record<string, unknown>): Promise<ToolJsonResult<T>>;
+/** Names of every tool the server lists (all pages), in server order. */
+export declare function listToolNames(client: Client): Promise<string[]>;
+export interface ToolCoverage {
+    /** Tools the server lists that have no case. */
+    missing: string[];
+    /** Cases naming a tool the server does not list. */
+    stale: string[];
+    /** Case names that appear more than once. */
+    duplicates: string[];
+    /** True when all three lists are empty. */
+    ok: boolean;
+}
+/** Compare the server's tool names with the suite's case names, both directions. Sorted output. */
+export declare function toolCoverage(actualNames: readonly string[], caseNames: readonly string[]): ToolCoverage;
+/** `toolCoverage`, throwing an Error that lists every gap when the sets differ. */
+export declare function assertToolCoverage(actualNames: readonly string[], caseNames: readonly string[]): ToolCoverage;
+export interface ToolWire {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema: unknown;
+    outputSchema?: unknown;
+    annotations?: unknown;
+    execution?: unknown;
+}
+/**
+ * The server's `tools/list` surface across every page, reduced to the wire fields, sorted by name and
+ * round-tripped through JSON so it compares stably against a stored fixture.
+ */
+export declare function captureToolWire(client: Client): Promise<ToolWire[]>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3E,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC;IACR,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,GAAG,EAAE,cAAc,CAAC;CACrB;AASD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAc5B;AAED,yEAAyE;AACzE,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGrE;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,EAAE,EAAE,OAAO,CAAC;CACb;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAYvG;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAW7G;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuBzE"}

package/dist/testing/tools.js

@@ -0,0 +1,98 @@
+/**
+ * @novorb/mcp-core/testing - tool call and tool coverage helpers over a connected v2 client.
+ */
+function firstText(result) {
+    for (const block of result.content ?? []) {
+        if (block.type === 'text')
+            return block.text;
+    }
+    return '';
+}
+/**
+ * Call a tool and decode its body. Tool-level failures come back as `isError: true` (not a throw);
+ * protocol errors (unknown tool, schema rejection on some servers) throw from the SDK as usual.
+ */
+export async function callToolJson(client, name, args = {}) {
+    const raw = await client.callTool({ name, arguments: args });
+    const text = firstText(raw);
+    let body;
+    if (raw.structuredContent !== undefined) {
+        body = raw.structuredContent;
+    }
+    else if (text !== '') {
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            body = text;
+        }
+    }
+    return { isError: raw.isError === true, body: body, text, raw };
+}
+/** Names of every tool the server lists (all pages), in server order. */
+export async function listToolNames(client) {
+    const { tools } = await client.listTools();
+    return tools.map((t) => t.name);
+}
+/** Compare the server's tool names with the suite's case names, both directions. Sorted output. */
+export function toolCoverage(actualNames, caseNames) {
+    const actual = new Set(actualNames);
+    const cases = new Set();
+    const dup = new Set();
+    for (const c of caseNames) {
+        if (cases.has(c))
+            dup.add(c);
+        cases.add(c);
+    }
+    const missing = [...actual].filter((n) => !cases.has(n)).sort();
+    const stale = [...cases].filter((n) => !actual.has(n)).sort();
+    const duplicates = [...dup].sort();
+    return { missing, stale, duplicates, ok: missing.length === 0 && stale.length === 0 && duplicates.length === 0 };
+}
+/** `toolCoverage`, throwing an Error that lists every gap when the sets differ. */
+export function assertToolCoverage(actualNames, caseNames) {
+    const cov = toolCoverage(actualNames, caseNames);
+    if (!cov.ok) {
+        const parts = [
+            `tools without a case: [${cov.missing.join(', ')}]`,
+            `stale cases (no such tool): [${cov.stale.join(', ')}]`,
+        ];
+        if (cov.duplicates.length > 0)
+            parts.push(`duplicate cases: [${cov.duplicates.join(', ')}]`);
+        throw new Error(`Tool coverage mismatch: ${parts.join('; ')}`);
+    }
+    return cov;
+}
+const WIRE_KEYS = ['name', 'title', 'description', 'inputSchema', 'outputSchema', 'annotations', 'execution'];
+/**
+ * The server's `tools/list` surface across every page, reduced to the wire fields, sorted by name and
+ * round-tripped through JSON so it compares stably against a stored fixture.
+ */
+export async function captureToolWire(client) {
+    const wire = [];
+    let cursor;
+    const seen = new Set();
+    do {
+        const page = await client.listTools(cursor === undefined ? undefined : { cursor });
+        for (const tool of page.tools) {
+            const entry = {};
+            for (const key of WIRE_KEYS) {
+                const value = tool[key];
+                if (value !== undefined)
+                    entry[key] = value;
+            }
+            wire.push(entry);
+        }
+        cursor = page.nextCursor;
+        if (cursor === '')
+            throw new Error('captureToolWire: tools/list returned an empty nextCursor');
+        if (cursor !== undefined) {
+            if (seen.has(cursor))
+                throw new Error('captureToolWire: tools/list returned a repeated nextCursor');
+            seen.add(cursor);
+        }
+    } while (cursor !== undefined);
+    wire.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    return JSON.parse(JSON.stringify(wire));
+}
+//# sourceMappingURL=tools.js.map

package/dist/testing/tools.js.map

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

package/dist/testing/unit.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @novorb/mcp-core/testing - in-process UNIT helpers: call a server's tools by name over the in-memory
+ * transport (no child process, no network) and assert on the outcome without a test-runner import.
+ *
+ * Observed SDK v2 behaviour for an McpServer (pinned by mcp-core's own tests):
+ * - arguments that fail the tool's inputSchema come back as a RESULT with `isError: true` and text
+ *   starting `Input validation error:`;
+ * - an unknown tool name is a THROWN ProtocolError, code -32602 (InvalidParams), `Tool <name> not found`.
+ * Low-level `Server` consumers may surface either one either way, so the helpers accept both.
+ */
+import type { Client } from '@modelcontextprotocol/client';
+import type { ServerFactory } from '../transport.js';
+import type { TestClientOptions } from './client.js';
+import { type ToolJsonResult } from './tools.js';
+/** JSON-RPC InvalidParams: the code the SDK uses for unknown tools (and some schema rejections). */
+export declare const INVALID_PARAMS_CODE = -32602;
+/** Run `fn` with a client connected in memory to `factory`; always closes. */
+export declare function withInMemoryClient<R>(factory: ServerFactory, fn: (client: Client) => Promise<R>, options?: TestClientOptions): Promise<R>;
+/** Build a server from `factory`, call one tool in memory, decode the result, and close. */
+export declare function callToolInMemory<T = unknown>(factory: ServerFactory, name: string, args?: Record<string, unknown>, options?: TestClientOptions): Promise<ToolJsonResult<T>>;
+/** The outcome of a call that may either return a result or throw a protocol error. */
+export type ToolOutcome<T = unknown> = {
+    kind: 'result';
+    result: ToolJsonResult<T>;
+} | {
+    kind: 'protocol-error';
+    code: number | undefined;
+    message: string;
+};
+/** Call a tool and capture a thrown protocol error as data instead of rethrowing it. */
+export declare function captureToolCall<T = unknown>(client: Client, name: string, args?: Record<string, unknown>): Promise<ToolOutcome<T>>;
+/** Throw unless `result.isError` is true (and its text matches `pattern`); returns the error text. */
+export declare function expectToolError(result: ToolJsonResult, pattern?: string | RegExp): string;
+/** Throw unless the result is a success; returns the decoded body. */
+export declare function expectToolSuccess<T>(result: ToolJsonResult<T>): T;
+export interface Rejection {
+    /** How the rejection surfaced. */
+    via: 'tool-error' | 'protocol-error';
+    message: string;
+}
+/**
+ * Call a tool with arguments its schema must reject and throw unless it was rejected: an isError result
+ * (`Input validation error` on McpServer) or an InvalidParams protocol error.
+ */
+export declare function expectSchemaRejection(client: Client, name: string, args: Record<string, unknown>): Promise<Rejection>;
+/**
+ * Call a tool name the server does not have and throw unless it was refused: a protocol error, or an
+ * isError result whose text says the tool is unknown / not found (any other error result, such as a
+ * schema rejection of an EXISTING tool, does not count).
+ */
+export declare function expectUnknownTool(client: Client, name: string): Promise<Rejection>;
+//# sourceMappingURL=unit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unit.d.ts","sourceRoot":"","sources":["../../src/testing/unit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,8EAA8E;AAC9E,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,4FAA4F;AAC5F,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAChD,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAE5B;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wFAAwF;AACxF,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAWzB;AAOD,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQzF;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAGjE;AAED,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,SAAS,CAAC,CAcpB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAOxF"}