@slbdn/mcp-tester 1.4.1 → 1.5.3

package/dist/generate-tests.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Test code generator — connects to an MCP server, inspects its capabilities,
+ * and generates a ready-to-run Jest/Vitest test file.
+ *
+ * @module generate-tests
+ */
+import { MCPClient } from './client/MCPClient.js';
+import type { ServerConfig } from './client/MCPClient.js';
+import type { Tool, Resource, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import { type GeneratedCase } from './generate-cases.js';
+import { type AIProvider, type OpenAICompatOptions } from './ai/provider.js';
+/**
+ * How test cases are derived.
+ *
+ * - `'static'` — the classic generator: one listing test + one probe call per
+ *   tool. @defaultValue
+ * - `'edge'` — additionally derives boundary/invalid cases from each tool's
+ *   JSON Schema (offline, deterministic).
+ * - `'ai'` — edge cases plus AI-suggested cases. Requires a provider (see
+ *   {@link GenerateTestOptions.provider} or the `MCP_TESTER_AI_*` env vars);
+ *   falls back to `'edge'` with a warning unless {@link GenerateTestOptions.requireAi}
+ *   is set.
+ */
+export type GenerationMode = 'static' | 'edge' | 'ai';
+/** AI configuration accepted by the generate functions. */
+export interface AIOptions extends OpenAICompatOptions {
+    /** Fail instead of falling back to deterministic cases when AI is unavailable. @defaultValue false */
+    requireAi?: boolean;
+}
+/**
+ * Options for test generation.
+ */
+export interface GenerateTestOptions {
+    /** Command to run the MCP server. */
+    command: string;
+    /** Arguments for the server command. */
+    args?: string[];
+    /** Test framework to target. @defaultValue 'jest' */
+    framework?: 'jest' | 'vitest';
+    /** Include resource tests. @defaultValue true */
+    includeResources?: boolean;
+    /** Include prompt tests. @defaultValue true */
+    includePrompts?: boolean;
+    /** Include tool call tests. @defaultValue true */
+    includeTools?: boolean;
+    /** Include matchers import. @defaultValue true */
+    includeMatchers?: boolean;
+    /** Timeout in ms for connecting to the server. @defaultValue 30000 */
+    timeout?: number;
+    /** Description for the test suite. */
+    description?: string;
+    /** How test cases are derived. @defaultValue 'static' */
+    mode?: GenerationMode;
+    /** Pre-built AI provider; overrides env-based discovery. */
+    provider?: AIProvider;
+    /** AI provider configuration (used when `provider` is not supplied). */
+    ai?: AIOptions;
+    /** Dry-run every derived case against the live server and annotate the
+     *  generated tests with what actually happens. @defaultValue false */
+    verify?: boolean;
+}
+/**
+ * Collapse control characters (including line terminators) so untrusted text
+ * can be embedded in a `//` line comment without terminating it. Model-provided
+ * rationales are the main caller — a raw newline would otherwise let the text
+ * escape the comment and become executable test code.
+ */
+export declare function escapeLineComment(s: string): string;
+/** Escape a string for use inside a single- or double-quoted JavaScript literal. */
+export declare function escapeJsString(s: string, quote?: "'" | '"'): string;
+/**
+ * Options consumed by {@link buildTestFile} (server description is passed separately).
+ */
+type TestBuildOptions = Pick<GenerateTestOptions, 'framework' | 'description' | 'includeResources' | 'includePrompts' | 'includeTools' | 'includeMatchers'>;
+/**
+ * Generate a complete test file.
+ *
+ * @internal Exported for testing; consumers should use {@link generateTests}
+ * or {@link generateTestsFromClient}.
+ */
+export declare function buildTestFile(tools: Tool[], resources: Resource[], prompts: Prompt[], options: TestBuildOptions, server: ServerConfig, cases?: GeneratedCase[]): string;
+/**
+ * Connect to an MCP server, inspect capabilities, and generate a test file.
+ *
+ * @returns The generated test file content
+ */
+export declare function generateTests(options: GenerateTestOptions): Promise<string>;
+/**
+ * Options for {@link generateTestsFromClient}.
+ */
+export type GenerateTestsFromClientOptions = Pick<GenerateTestOptions, 'framework' | 'description' | 'includeResources' | 'includePrompts' | 'includeTools' | 'includeMatchers' | 'mode' | 'provider' | 'ai' | 'verify' | 'timeout'>;
+/**
+ * Generate a test file from an already-connected client.
+ *
+ * Unlike {@link generateTests}, this supports any transport (stdio, HTTP, SSE)
+ * because the caller owns the connection. The generated test file embeds the
+ * supplied `server` config so it can reconnect on its own.
+ *
+ * @param client - A connected MCPClient instance
+ * @param server - The config the generated test should use to connect
+ * @param options - Generation options
+ * @returns The generated test file content
+ */
+export declare function generateTestsFromClient(client: MCPClient, server: ServerConfig, options?: GenerateTestsFromClientOptions): Promise<string>;
+export {};
+//# sourceMappingURL=generate-tests.d.ts.map

package/dist/generate-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.d.ts","sourceRoot":"","sources":["../src/generate-tests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjF,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;AAEtD,2DAA2D;AAC3D,MAAM,WAAW,SAAU,SAAQ,mBAAmB;IACpD,sGAAsG;IACtG,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,wEAAwE;IACxE,EAAE,CAAC,EAAE,SAAS,CAAC;IACf;0EACsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAsFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,GAAG,GAAS,GAAG,MAAM,CAYxE;AA+HD;;GAEG;AACH,KAAK,gBAAgB,GAAG,IAAI,CAC1B,mBAAmB,EACjB,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,aAAa,EAAO,GAC1B,MAAM,CAgGR;AAmGD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BjF;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,mBAAmB,EACjB,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,MAAM,GACN,UAAU,GACV,IAAI,GACJ,QAAQ,GACR,SAAS,CACZ,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/generate-tests.js

@@ -0,0 +1,441 @@
+/**
+ * Test code generator — connects to an MCP server, inspects its capabilities,
+ * and generates a ready-to-run Jest/Vitest test file.
+ *
+ * @module generate-tests
+ */
+import { MCPClient } from './client/MCPClient.js';
+import { getPackageVersion } from './utils/version.js';
+import { generateToolArgs, suggestEdgeCasesForTools, mergeAndValidateCases, } from './generate-cases.js';
+import { createProviderFromEnv, } from './ai/provider.js';
+/**
+ * Build the `client.start({ ... })` config literal for the generated test.
+ * Uses JSON.stringify for values so quotes/backslashes are safely escaped.
+ */
+function formatServerStart(server) {
+    if (server.transport === 'http' || server.transport === 'sse') {
+        const parts = [`transport: '${server.transport}'`, `url: ${JSON.stringify(server.url)}`];
+        if (server.headers && Object.keys(server.headers).length > 0) {
+            parts.push(`headers: ${JSON.stringify(server.headers)}`);
+        }
+        return parts.join(',\n      ');
+    }
+    const stdio = server;
+    const parts = [`command: ${JSON.stringify(stdio.command)}`];
+    if (stdio.args && stdio.args.length > 0) {
+        parts.push(`args: ${JSON.stringify(stdio.args)}`);
+    }
+    return parts.join(',\n      ');
+}
+/** Human-readable server target for the generated file header. */
+function formatServerLabel(server) {
+    if (server.transport === 'http' || server.transport === 'sse') {
+        return `${server.transport} ${server.url}`;
+    }
+    const stdio = server;
+    return `${stdio.command}${stdio.args && stdio.args.length > 0 ? ' ' + stdio.args.join(' ') : ''}`;
+}
+/**
+ * Render one derived test case as an `it(...)` block.
+ */
+function generateCaseTest(c) {
+    const lines = [];
+    const argsStr = JSON.stringify(c.args);
+    lines.push(`    // ${c.source} — ${escapeLineComment(c.rationale)}`);
+    // --verify found the server behaving differently than predicted: keep the
+    // case for visibility but skip it, and say what actually happened.
+    if (c.observed && c.expectation !== 'observe' && c.observed !== c.expectation) {
+        lines.push(`    // verify: expected ${c.expectation} but server returned ${c.observed} — adjust manually`);
+        lines.push(`    it.skip('${escapeJsString(c.title)}', async () => {`);
+        lines.push('      const result = await client.callTool({');
+        lines.push(`        name: '${toolNameLiteral(c.tool)}',`);
+        lines.push(`        arguments: ${argsStr},`);
+        lines.push('      }).catch((error: unknown) => error);');
+        lines.push('      expect(result).toBeDefined();');
+        lines.push('    });');
+        return lines;
+    }
+    if (c.expectation === 'observe') {
+        lines.push(`    it('${escapeJsString(c.title)}', async () => {`);
+        lines.push('      const result = await client.callTool({');
+        lines.push(`        name: '${toolNameLiteral(c.tool)}',`);
+        lines.push(`        arguments: ${argsStr},`);
+        lines.push('      }).catch((error: unknown) => error);');
+        lines.push('      // Observation only — record what the server actually does.');
+        lines.push('      expect(result).toBeDefined();');
+        lines.push(`      console.log('[${toolNameLiteral(c.tool)}]', JSON.stringify(result));`);
+        lines.push('    });');
+    }
+    else if (c.expectation === 'error') {
+        lines.push(`    it('${escapeJsString(c.title)}', async () => {`);
+        lines.push('      const result = await client.callTool({');
+        lines.push(`        name: '${toolNameLiteral(c.tool)}',`);
+        lines.push(`        arguments: ${argsStr},`);
+        lines.push('      }).catch((error: unknown) => error);');
+        lines.push('      expect(isToolError(result)).toBe(true);');
+        lines.push('    });');
+    }
+    else {
+        lines.push(`    it('${escapeJsString(c.title)}', async () => {`);
+        lines.push('      const result = await client.callTool({');
+        lines.push(`        name: '${toolNameLiteral(c.tool)}',`);
+        lines.push(`        arguments: ${argsStr},`);
+        lines.push('      }).catch((error: unknown) => error);');
+        lines.push('      expect(isToolError(result)).toBe(false);');
+        lines.push('    });');
+    }
+    return lines;
+}
+/**
+ * Collapse control characters (including line terminators) so untrusted text
+ * can be embedded in a `//` line comment without terminating it. Model-provided
+ * rationales are the main caller — a raw newline would otherwise let the text
+ * escape the comment and become executable test code.
+ */
+export function escapeLineComment(s) {
+    // eslint-disable-next-line no-control-regex -- intentional: collapse control chars and line terminators
+    return s.replace(/[\u0000-\u001f\u2028\u2029]+/g, ' ');
+}
+/** Escape a string for use inside a single- or double-quoted JavaScript literal. */
+export function escapeJsString(s, quote = "'") {
+    // Escape backslashes first, then the chosen quote, then newlines/control chars.
+    return (s
+        .replace(/\\/g, '\\\\')
+        .replace(new RegExp(quote, 'g'), `\\${quote}`)
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        // eslint-disable-next-line no-control-regex -- intentional: we want to escape ASCII control chars in user-provided strings
+        .replace(/[\u0000-\u001f]/g, (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, '0')}`));
+}
+/** Emit a safe single-quoted string literal for a tool name. */
+function toolNameLiteral(name) {
+    return escapeJsString(name, "'");
+}
+/**
+ * Generate tool test cases.
+ */
+function generateToolTests(tools, cases = []) {
+    if (tools.length === 0)
+        return '';
+    const lines = ["  describe('Tools', () => {"];
+    if (cases.length > 0) {
+        lines.push('    const isToolError = (res: unknown): boolean =>');
+        lines.push('      res instanceof Error ||');
+        lines.push('      (typeof res === "object" && res !== null && (res as { isError?: unknown }).isError === true);');
+    }
+    for (const tool of tools) {
+        const sampleArgs = generateToolArgs(tool);
+        const argsStr = Object.keys(sampleArgs).length > 0 ? JSON.stringify(sampleArgs) : '{}';
+        lines.push('');
+        lines.push(`    it('should have tool "${escapeJsString(tool.name, "'")}"', async () => {`);
+        lines.push('      const tools = await client.listTools();');
+        lines.push(`      expect(tools).toHaveTool('${toolNameLiteral(tool.name)}');`);
+        lines.push('    });');
+        lines.push('');
+        // Call test. Generated arguments are guesses, and some tools intentionally
+        // return/throw errors — so accept a successful result or a tool-level error.
+        lines.push(`    it('should call "${escapeJsString(tool.name, "'")}"', async () => {`);
+        lines.push('      const result = await client.callTool({');
+        lines.push(`        name: '${toolNameLiteral(tool.name)}',`);
+        lines.push(`        arguments: ${argsStr},`);
+        lines.push('      }).catch((error: unknown) => error);');
+        lines.push('      expect(result).toBeDefined();');
+        lines.push('    });');
+        // Derived edge/AI cases for this tool.
+        for (const c of cases.filter((c) => c.tool === tool.name)) {
+            lines.push('');
+            lines.push(...generateCaseTest(c));
+        }
+    }
+    lines.push('  });');
+    return lines.join('\n');
+}
+/**
+ * Generate resource test cases.
+ */
+function generateResourceTests(resources) {
+    if (resources.length === 0)
+        return '';
+    const lines = ["  describe('Resources', () => {"];
+    for (const resource of resources) {
+        lines.push('');
+        lines.push(`    it('should have resource "${escapeJsString(resource.uri, "'")}"', async () => {`);
+        lines.push('      const resources = await client.listResources();');
+        lines.push(`      expect(resources).toHaveResource('${escapeJsString(resource.uri, "'")}');`);
+        lines.push('    });');
+        lines.push('');
+        lines.push(`    it('should read resource "${escapeJsString(resource.uri, "'")}"', async () => {`);
+        lines.push(`      const result = await client.readResource('${escapeJsString(resource.uri, "'")}');`);
+        lines.push('      expect(result.contents).toBeDefined();');
+        lines.push('      expect(result.contents.length).toBeGreaterThan(0);');
+        lines.push('    });');
+    }
+    lines.push('  });');
+    return lines.join('\n');
+}
+/**
+ * Generate prompt test cases.
+ */
+function generatePromptTests(prompts) {
+    if (prompts.length === 0)
+        return '';
+    const lines = ["  describe('Prompts', () => {"];
+    for (const prompt of prompts) {
+        // Generate sample args from prompt arguments
+        const promptArgs = {};
+        if (prompt.arguments && Array.isArray(prompt.arguments)) {
+            for (const arg of prompt.arguments) {
+                if (arg.required) {
+                    promptArgs[arg.name] = `example-${arg.name}`;
+                }
+            }
+        }
+        const argsStr = Object.keys(promptArgs).length > 0 ? `, ${JSON.stringify(promptArgs)}` : '';
+        lines.push('');
+        lines.push(`    it('should have prompt "${escapeJsString(prompt.name, "'")}"', async () => {`);
+        lines.push('      const prompts = await client.listPrompts();');
+        lines.push(`      expect(prompts).toHavePrompt('${escapeJsString(prompt.name, "'")}');`);
+        lines.push('    });');
+        lines.push('');
+        lines.push(`    it('should get prompt "${escapeJsString(prompt.name, "'")}"', async () => {`);
+        lines.push(`      const result = await client.getPrompt('${escapeJsString(prompt.name, "'")}'${argsStr});`);
+        lines.push('      expect(result.messages).toBeDefined();');
+        lines.push('      expect(result.messages.length).toBeGreaterThan(0);');
+        lines.push('    });');
+    }
+    lines.push('  });');
+    return lines.join('\n');
+}
+/**
+ * Generate a complete test file.
+ *
+ * @internal Exported for testing; consumers should use {@link generateTests}
+ * or {@link generateTestsFromClient}.
+ */
+export function buildTestFile(tools, resources, prompts, options, server, cases = []) {
+    const framework = options.framework || 'jest';
+    const description = options.description || 'MCP Server';
+    const startCmd = formatServerStart(server);
+    const serverLabel = formatServerLabel(server);
+    const includeMatchers = options.includeMatchers !== false;
+    // Imports
+    const importLines = [];
+    // Triple-slash type directive must appear at the very top of the file.
+    let vitestReference = '';
+    if (framework === 'vitest') {
+        importLines.push("import { describe, it, expect, beforeAll, beforeEach, afterEach } from 'vitest';");
+        const extraImports = includeMatchers ? ', setupVitestMatchers' : '';
+        importLines.push(`import { MCPClient${extraImports} } from '@slbdn/mcp-tester';`);
+        if (includeMatchers) {
+            vitestReference = '/// <reference types="@slbdn/mcp-tester/vitest" />\n\n';
+        }
+    }
+    else {
+        importLines.push("import { describe, it, expect, beforeAll, beforeEach, afterEach } from '@jest/globals';");
+        const extraImports = includeMatchers ? ', setupJestMatchers' : '';
+        importLines.push(`import { MCPClient${extraImports} } from '@slbdn/mcp-tester';`);
+    }
+    // Header comment
+    const header = [
+        '/**',
+        ` * Generated test file for: ${description.replace(/\*\//g, '*\\/')}`,
+        ' *',
+        ` * Framework: ${framework}`,
+        ` * Server: ${serverLabel.replace(/\*\//g, '*\\/')}`,
+        ` * Tools: ${tools.length} | Resources: ${resources.length} | Prompts: ${prompts.length}`,
+        cases.length > 0 ? ` * Derived cases: ${cases.length} (edge/AI)` : null,
+        ' *',
+        ` * Generated by @slbdn/mcp-tester v${getPackageVersion()}`,
+        ' * Run: npx jest --testTimeout=30000 (or npx vitest run)',
+        ' */',
+    ]
+        .filter((line) => line !== null)
+        .join('\n');
+    // Test sections
+    const toolTests = options.includeTools !== false ? generateToolTests(tools, cases) : '';
+    const resourceTests = options.includeResources !== false ? generateResourceTests(resources) : '';
+    const promptTests = options.includePrompts !== false ? generatePromptTests(prompts) : '';
+    // Combine
+    const sections = [toolTests, resourceTests, promptTests].filter(Boolean);
+    const beforeAllLine = includeMatchers
+        ? framework === 'vitest'
+            ? 'beforeAll(() => setupVitestMatchers());'
+            : 'beforeAll(() => setupJestMatchers());'
+        : '';
+    return `${vitestReference}${header}
+
+${importLines.join('\n')}
+
+${beforeAllLine}
+describe('${escapeJsString(description, "'")}', () => {
+  let client: MCPClient;
+
+  beforeEach(async () => {
+    client = new MCPClient({
+      name: 'test-client',
+      version: '1.0.0',
+    });
+    await client.start({
+      ${startCmd}
+    });
+  });
+
+  afterEach(async () => {
+    if (client.isConnected()) {
+      await client.stop();
+    }
+  });
+
+  it('should connect to the server', () => {
+    expect(client.isConnected()).toBe(true);
+  });
+
+  it('should list tools', async () => {
+    const tools = await client.listTools();
+    expect(Array.isArray(tools)).toBe(true);
+  });
+
+${sections.join('\n\n')}
+});
+`;
+}
+/**
+ * Derive test cases for the requested {@link GenerationMode}.
+ *
+ * - `static` → no extra cases
+ * - `edge` → deterministic schema rules
+ * - `ai` → rules + AI-suggested cases (validated against the real schemas)
+ *
+ * @returns The cases, a diagnostics string (or null), and whether AI ran.
+ */
+async function buildCases(tools, options, serverLabel) {
+    const mode = options.mode ?? 'static';
+    if (mode === 'static' || options.includeTools === false || tools.length === 0) {
+        return { cases: [], note: null, usedAI: false };
+    }
+    const ruleCases = suggestEdgeCasesForTools(tools);
+    if (mode === 'edge') {
+        return { cases: ruleCases, note: null, usedAI: false };
+    }
+    // mode === 'ai'
+    const provider = options.provider ?? createProviderFromEnv();
+    if (!provider) {
+        if (options.ai?.requireAi) {
+            throw new Error('AI generation requested with requireAi, but no provider is available. ' +
+                'Set MCP_TESTER_AI_API_KEY (and optionally MCP_TESTER_AI_BASE_URL / MCP_TESTER_AI_MODEL), ' +
+                'or pass a provider.');
+        }
+        return {
+            cases: ruleCases,
+            note: 'No AI provider configured (set MCP_TESTER_AI_API_KEY); ' +
+                'fell back to deterministic edge cases.',
+            usedAI: false,
+        };
+    }
+    const analysis = {
+        serverLabel,
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    };
+    const aiCases = await provider.suggestCases(analysis);
+    const schemas = new Map(tools.map((t) => [t.name, t]));
+    const { cases, rejected } = mergeAndValidateCases([ruleCases, aiCases], schemas);
+    // Only AI cases can be rejected (rule cases are exempt from schema
+    // validation), but count by source so the diagnostic stays correct if that
+    // ever changes.
+    const dropped = rejected.filter((r) => r.c.source.startsWith('ai:')).length;
+    const note = dropped > 0
+        ? `AI suggested cases: ${aiCases.length}, kept after schema validation: ${aiCases.length - dropped} (dropped ${dropped})`
+        : null;
+    return { cases, note, usedAI: true };
+}
+/**
+ * Dry-run every derived case against the live server and record what actually
+ * happens in `case.observed`. The renderer turns mismatches into `it.skip`
+ * blocks with an explanatory comment.
+ */
+async function verifyCases(client, cases, timeout) {
+    for (const c of cases) {
+        if (c.expectation === 'observe')
+            continue;
+        try {
+            const result = await client.callTool({
+                name: c.tool,
+                arguments: c.args,
+                timeout: Math.min(timeout, 15_000),
+            });
+            const isError = result.isError === true;
+            c.observed = isError ? 'error' : 'success';
+        }
+        catch {
+            c.observed = 'error';
+        }
+    }
+}
+/**
+ * Connect to an MCP server, inspect capabilities, and generate a test file.
+ *
+ * @returns The generated test file content
+ */
+export async function generateTests(options) {
+    const client = new MCPClient({
+        name: 'mcp-tester-generate',
+        version: '1.0.0',
+        timeout: options.timeout || 30000,
+        logLevel: 'none',
+    });
+    try {
+        await client.start({
+            command: options.command,
+            args: options.args,
+        });
+        const [tools, resources, prompts] = await Promise.all([
+            options.includeTools === false ? Promise.resolve([]) : client.listTools(),
+            options.includeResources === false ? Promise.resolve([]) : client.listResources(),
+            options.includePrompts === false ? Promise.resolve([]) : client.listPrompts(),
+        ]);
+        const server = { command: options.command, args: options.args };
+        const serverLabel = formatServerLabel(server);
+        const { cases, note } = await buildCases(tools, options, serverLabel);
+        if (note)
+            console.warn(`mcp-tester: ${note}`);
+        if (options.verify && cases.length > 0) {
+            await verifyCases(client, cases, options.timeout || 30000);
+        }
+        return buildTestFile(tools, resources, prompts, options, server, cases);
+    }
+    finally {
+        await client.stop();
+    }
+}
+/**
+ * Generate a test file from an already-connected client.
+ *
+ * Unlike {@link generateTests}, this supports any transport (stdio, HTTP, SSE)
+ * because the caller owns the connection. The generated test file embeds the
+ * supplied `server` config so it can reconnect on its own.
+ *
+ * @param client - A connected MCPClient instance
+ * @param server - The config the generated test should use to connect
+ * @param options - Generation options
+ * @returns The generated test file content
+ */
+export async function generateTestsFromClient(client, server, options = {}) {
+    const [tools, resources, prompts] = await Promise.all([
+        options.includeTools === false ? Promise.resolve([]) : client.listTools(),
+        options.includeResources === false ? Promise.resolve([]) : client.listResources(),
+        options.includePrompts === false ? Promise.resolve([]) : client.listPrompts(),
+    ]);
+    const { cases, note } = await buildCases(tools, options, formatServerLabel(server));
+    if (note)
+        console.warn(`mcp-tester: ${note}`);
+    if (options.verify && cases.length > 0) {
+        await verifyCases(client, cases, options.timeout || 30000);
+    }
+    return buildTestFile(tools, resources, prompts, options, server, cases);
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/generate-tests.js.map

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

package/dist/generate-types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * TypeScript type generator — connects to an MCP server, reads tool schemas,
+ * and generates a `.d.ts` TypeScript declaration file with typed interfaces.
+ *
+ * @module generate-types
+ */
+import { MCPClient } from './client/MCPClient.js';
+/**
+ * Options for type generation.
+ */
+export interface GenerateTypesOptions {
+    /** Command to run the MCP server. */
+    command: string;
+    /** Arguments for the server command. */
+    args?: string[];
+    /** Timeout in ms for connecting to the server. @defaultValue 30000 */
+    timeout?: number;
+    /** Include resource URI types. @defaultValue true */
+    includeResources?: boolean;
+    /** Include prompt argument types. @defaultValue true */
+    includePrompts?: boolean;
+    /** Module name for the import type. @defaultValue '@slbdn/mcp-tester' */
+    moduleName?: string;
+}
+type JsonSchema = Record<string, unknown>;
+/**
+ * Convert a JSON Schema type to a TypeScript type string.
+ * Handles primitives, arrays, objects, enums, nullable, and compositions.
+ * Exported for unit testing.
+ */
+export declare function schemaToType(schema: JsonSchema, indent?: number): string;
+/**
+ * Emit TypeScript aliases for every `$ref`-referenced schema, resolved from the
+ * schema's `$defs` / `definitions`. Unresolved refs fall back to `unknown` so the
+ * generated file always type-checks instead of referencing undefined types.
+ */
+export declare function generateRefTypes(schema: JsonSchema): string;
+/** Escape a property name for use in TypeScript (quote if needed). Exported for testing. */
+export declare function escapePropertyName(name: string): string;
+/** Sanitize a tool/prompt name into a valid TypeScript identifier. Exported for testing. */
+export declare function toTypeName(name: string): string;
+/**
+ * Options for {@link generateTypesFromClient}.
+ */
+export interface GenerateTypesFromClientOptions {
+    /** Module name for the import hint. @defaultValue '@slbdn/mcp-tester' */
+    moduleName?: string;
+    /** Include resource URI types. @defaultValue true */
+    includeResources?: boolean;
+    /** Include prompt argument types. @defaultValue true */
+    includePrompts?: boolean;
+    /** Human-readable label for the server, used only in the generated header. */
+    serverLabel?: string;
+}
+/**
+ * Generate TypeScript type declarations from an already-connected client.
+ *
+ * Unlike {@link generateTypes}, this supports any transport (stdio, HTTP, SSE)
+ * because the caller owns the connection.
+ *
+ * @param client - A connected MCPClient instance
+ * @param options - Generation options
+ * @returns The generated `.d.ts` file content
+ */
+export declare function generateTypesFromClient(client: MCPClient, options?: GenerateTypesFromClientOptions): Promise<string>;
+/**
+ * Connect to an MCP server, inspect tool schemas, and generate TypeScript type declarations.
+ *
+ * @returns The generated `.d.ts` file content
+ *
+ * @example
+ * ```typescript
+ * import { generateTypes } from '@slbdn/mcp-tester';
+ * import { writeFileSync } from 'fs';
+ *
+ * const types = await generateTypes({
+ *   command: 'node',
+ *   args: ['./my-server.js'],
+ * });
+ *
+ * writeFileSync('my-server-types.d.ts', types);
+ * ```
+ */
+export declare function generateTypes(options: GenerateTypesOptions): Promise<string>;
+export {};
+//# sourceMappingURL=generate-types.d.ts.map