@gleanwork/mcp-server-tester 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/index.cjs

@@ -3127,7 +3127,7 @@ var init_dist3 = __esm({
   }
 });
 var MCPHostCapabilitiesSchema = zod.z.object({
-  sampling: zod.z.record(zod.z.unknown()).optional(),
+  sampling: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   roots: zod.z.object({
     listChanged: zod.z.boolean()
   }).optional()
@@ -3186,7 +3186,7 @@ var HttpConfigSchema = zod.z.object({
     }
     return true;
   }),
-  headers: zod.z.record(zod.z.string()).optional(),
+  headers: zod.z.record(zod.z.string(), zod.z.string()).optional(),
   capabilities: MCPHostCapabilitiesSchema.optional(),
   connectTimeoutMs: zod.z.number().positive().optional(),
   requestTimeoutMs: zod.z.number().positive().optional(),
@@ -4407,7 +4407,7 @@ function escapeHtml(text) {
 
 // package.json
 var package_default = {
-  version: "1.0.0-beta.2"};
+  version: "1.0.0-beta.4"};
 
 // src/mcp/clientFactory.ts
 function getRetryAfterDelayMs(err) {
@@ -4498,7 +4498,10 @@ async function createMCPClientForConfig(config, options) {
       validatedConfig.connectTimeoutMs !== void 0 ? { timeout: validatedConfig.connectTimeoutMs } : void 0
     );
   } else if (isHttpConfig(validatedConfig)) {
-    const headers = { ...validatedConfig.headers };
+    const headers = {
+      "User-Agent": `@gleanwork/mcp-server-tester/${package_default.version}`,
+      ...validatedConfig.headers
+    };
     if (validatedConfig.auth?.clientCredentials && !options?.authProvider) {
       const ccConfig = validatedConfig.auth.clientCredentials;
       const clientId = ccConfig.clientId ?? process.env["MCP_CLIENT_ID"];
@@ -5148,7 +5151,7 @@ function validateToolCalls(response, expectation) {
   if (!isSimulationResult(response)) {
     return {
       pass: false,
-      message: "toolsTriggered expectation requires llm_host mode \u2014 response must be an LLMHostSimulationResult"
+      message: "toolsTriggered expectation requires mcp_host mode \u2014 response must be an MCPHostSimulationResult"
     };
   }
   const actual = response.toolCalls;
@@ -5208,7 +5211,7 @@ function validateToolCallCount(response, options) {
   if (!isSimulationResult(response)) {
     return {
       pass: false,
-      message: "toolCallCount expectation requires llm_host mode \u2014 response must be an LLMHostSimulationResult"
+      message: "toolCallCount expectation requires mcp_host mode \u2014 response must be an MCPHostSimulationResult"
     };
   }
   const count = response.toolCalls.length;
@@ -6330,7 +6333,7 @@ function getAuthConfigFromEnv() {
   }
   return void 0;
 }
-var LLMHostConfigSchema = zod.z.object({
+var MCPHostConfigSchema = zod.z.object({
   provider: zod.z.enum([
     "openai",
     "anthropic",
@@ -6399,7 +6402,7 @@ var EvalExpectBlockSchema = zod.z.object({
     calls: zod.z.array(
       zod.z.object({
         name: zod.z.string(),
-        arguments: zod.z.record(zod.z.unknown()).optional(),
+        arguments: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
         required: zod.z.boolean().optional()
       })
     ),
@@ -6415,12 +6418,12 @@ var EvalExpectBlockSchema = zod.z.object({
 var EvalCaseSchema = zod.z.object({
   id: zod.z.string().min(1, "id must not be empty"),
   description: zod.z.string().optional(),
-  mode: zod.z.enum(["direct", "llm_host"]).optional(),
+  mode: zod.z.enum(["direct", "mcp_host"]).optional(),
   toolName: zod.z.string().min(1, "toolName must not be empty").optional(),
-  args: zod.z.record(zod.z.unknown()).optional(),
+  args: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   scenario: zod.z.string().optional(),
-  llmHostConfig: LLMHostConfigSchema.optional(),
-  metadata: zod.z.record(zod.z.unknown()).optional(),
+  mcpHostConfig: MCPHostConfigSchema.optional(),
+  metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   iterations: zod.z.number().int().min(1).optional(),
   accuracyThreshold: zod.z.number().min(0).max(1).optional(),
   judgeReps: zod.z.number().int().min(1).optional(),
@@ -6432,7 +6435,7 @@ var EvalDatasetSchema = zod.z.object({
   name: zod.z.string().min(1, "name must not be empty"),
   description: zod.z.string().optional(),
   cases: zod.z.array(EvalCaseSchema).min(1, "dataset must have at least one case"),
-  metadata: zod.z.record(zod.z.unknown()).optional()
+  metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 });
 function validateEvalCase(evalCase) {
   return EvalCaseSchema.parse(evalCase);
@@ -6470,30 +6473,30 @@ function loadEvalDatasetFromObject(data, options = {}) {
   return dataset;
 }
 
-// src/evals/llmHost/adapters/vercel.ts
+// src/evals/mcpHost/adapters/vercel.ts
 function enrichErrorMessage(err, provider) {
   const raw = err instanceof Error ? err.message : String(err);
   if (raw.includes("Cannot find module") || raw.includes("ERR_MODULE_NOT_FOUND")) {
-    return `LLM host simulation failed: required package not installed.
-Hint: run \`getMissingDependencyMessage('${provider}')\` or check docs/llm-host.md for install instructions.`;
+    return `MCP host simulation failed: required package not installed.
+Hint: run \`getMissingDependencyMessage('${provider}')\` or check docs/mcp-host.md for install instructions.`;
   }
   if (raw.includes("401") || raw.includes("Unauthorized") || raw.includes("API key") || raw.includes("api_key")) {
-    return `LLM host simulation failed: authentication error.
+    return `MCP host simulation failed: authentication error.
 Hint: check your API key environment variable (e.g. ANTHROPIC_API_KEY, GOOGLE_APPLICATION_CREDENTIALS).`;
   }
   if (raw.includes("404") || raw.includes("Not Found") || raw.toLowerCase().includes("model") && raw.toLowerCase().includes("not found")) {
-    return `LLM host simulation failed: model not found.
+    return `MCP host simulation failed: model not found.
 Hint: check the model name format for your provider. For vertex-anthropic use 'claude-3-5-haiku@20241022' (with @).`;
   }
   if (raw.includes("ENOTFOUND") || raw.includes("fetch failed") || raw.includes("ECONNREFUSED")) {
-    return `LLM host simulation failed: network error.
+    return `MCP host simulation failed: network error.
 Hint: check network connectivity and whether the provider's API endpoint is reachable from this machine.`;
   }
   if (raw.includes("429") || raw.toLowerCase().includes("rate limit") || raw.includes("Too Many Requests")) {
-    return `LLM host simulation failed: rate limited.
+    return `MCP host simulation failed: rate limited.
 Hint: reduce concurrency, add delays between iterations, or upgrade your API plan.`;
   }
-  return `LLM host simulation failed: ${raw}`;
+  return `MCP host simulation failed: ${raw}`;
 }
 async function loadModel(provider, model) {
   switch (provider) {
@@ -6623,7 +6626,7 @@ function createVercelOrchestrator() {
   };
 }
 
-// src/evals/llmHost/llmHostSimulation.ts
+// src/evals/mcpHost/mcpHostSimulation.ts
 var vercelOrchestrator = createVercelOrchestrator();
 var allProviders = [
   "openai",
@@ -6639,7 +6642,7 @@ var allProviders = [
 var simulatorRegistry = new Map(
   allProviders.map((p) => [p, vercelOrchestrator])
 );
-async function simulateLLMHost(mcp, scenario, config) {
+async function simulateMCPHost(mcp, scenario, config) {
   const simulator = simulatorRegistry.get(config.provider);
   if (!simulator) {
     throw new Error(
@@ -6661,7 +6664,7 @@ function getMissingDependencyMessage(provider) {
     deepseek: "npm install ai @ai-sdk/deepseek",
     openrouter: "npm install ai @openrouter/ai-sdk-provider",
     xai: "npm install ai @ai-sdk/xai",
-    "vertex-anthropic": "npm install ai @ai-sdk/google-vertex (requires Application Default Credentials \u2014 see docs/llm-host.md)"
+    "vertex-anthropic": "npm install ai @ai-sdk/google-vertex (requires Application Default Credentials \u2014 see docs/mcp-host.md)"
   };
   const pkg = packageMap[provider];
   return pkg ? `${String(provider)} provider requires: ${pkg}` : `Unknown provider: ${String(provider)}`;
@@ -6704,24 +6707,24 @@ async function execFileNoThrow(file, args) {
 async function executeToolCall(evalCase, mcp) {
   const mode = evalCase.mode || "direct";
   try {
-    if (mode === "llm_host") {
+    if (mode === "mcp_host") {
       if (!evalCase.scenario) {
         throw new Error(
-          `Eval case ${evalCase.id}: scenario is required for llm_host mode`
+          `Eval case ${evalCase.id}: scenario is required for mcp_host mode`
         );
       }
-      if (!evalCase.llmHostConfig) {
+      if (!evalCase.mcpHostConfig) {
         throw new Error(
-          `Eval case ${evalCase.id}: llmHostConfig is required for llm_host mode`
+          `Eval case ${evalCase.id}: mcpHostConfig is required for mcp_host mode`
         );
       }
-      const simulationResult = await simulateLLMHost(
+      const simulationResult = await simulateMCPHost(
         mcp,
         evalCase.scenario,
-        evalCase.llmHostConfig
+        evalCase.mcpHostConfig
       );
       if (!simulationResult.success) {
-        throw new Error(simulationResult.error || "LLM host simulation failed");
+        throw new Error(simulationResult.error || "MCP host simulation failed");
       }
       return { response: simulationResult };
     } else {
@@ -6863,12 +6866,16 @@ async function runExpectBlockValidations(expectBlock, response, config) {
   }
   return { expectations: results, toolPrecision, toolRecall };
 }
+function isMCPHostSimulationResult(value) {
+  return typeof value === "object" && value !== null && "success" in value && "toolCalls" in value && Array.isArray(value.toolCalls);
+}
 async function runSingleIteration(evalCase, context, options) {
   const startTime = Date.now();
   const { response, error } = await executeToolCall(evalCase, context.mcp);
   let expectationResults = {};
   let toolPrecision;
   let toolRecall;
+  let mcpHostTrace;
   if (!error && evalCase.expect) {
     const {
       expectations,
@@ -6883,6 +6890,23 @@ async function runSingleIteration(evalCase, context, options) {
     expectationResults = expectations;
     toolPrecision = tp;
     toolRecall = tr;
+    if (evalCase.expect.toolsTriggered !== void 0 && isMCPHostSimulationResult(response)) {
+      const expectedNames = new Set(
+        evalCase.expect.toolsTriggered.calls.map((c) => c.name)
+      );
+      const requiredNames = new Set(
+        evalCase.expect.toolsTriggered.calls.filter((c) => c.required !== false).map((c) => c.name)
+      );
+      const calledNames = new Set(response.toolCalls.map((c) => c.name));
+      mcpHostTrace = {
+        calls: response.toolCalls.map((call) => ({
+          name: call.name,
+          arguments: call.arguments,
+          status: expectedNames.has(call.name) ? "expected" : "unexpected"
+        })),
+        missed: Array.from(requiredNames).filter((name15) => !calledNames.has(name15)).map((name15) => ({ name: name15 }))
+      };
+    }
   }
   return {
     id: evalCase.id,
@@ -6898,7 +6922,8 @@ async function runSingleIteration(evalCase, context, options) {
     durationMs: Date.now() - startTime,
     tags: evalCase.tags,
     toolPrecision,
-    toolRecall
+    toolRecall,
+    mcpHostTrace
   };
 }
 function isInfrastructureError(err) {
@@ -6951,7 +6976,6 @@ async function runEvalCase(evalCase, context, options = {}) {
   const passCount = assertionResults.filter((r) => r.pass).length;
   const assertionPassRate = assertionResults.length > 0 ? passCount / assertionResults.length : 0;
   const infrastructureErrorRate = infraErrors.length / iterations;
-  const accuracy = assertionPassRate;
   const threshold = evalCase.accuracyThreshold ?? 1;
   const baseResult = lastResult ?? {
     id: evalCase.id,
@@ -6968,10 +6992,9 @@ async function runEvalCase(evalCase, context, options = {}) {
   };
   return {
     ...baseResult,
-    pass: accuracy >= threshold,
+    pass: assertionPassRate >= threshold,
     assertionPassRate,
     infrastructureErrorRate,
-    accuracy,
     iterationResults,
     infrastructureErrorCount: infraErrors.length,
     durationMs: iterationResults.reduce((sum, r) => sum + r.durationMs, 0)
@@ -7006,7 +7029,7 @@ async function runEvalDataset(options, context) {
     filterTags,
     saveResultsTo,
     baselineResultsFrom,
-    llmHostModel,
+    mcpHostModel,
     judgeModel
   } = options;
   const startTime = Date.now();
@@ -7016,7 +7039,7 @@ async function runEvalDataset(options, context) {
   };
   const casesToRun = filterTags && filterTags.length > 0 ? dataset.cases.filter((c) => c.tags?.some((t) => filterTags.includes(t))) : dataset.cases;
   const estimatedJudgeCalls = casesToRun.reduce((sum, c) => {
-    const effectiveIterations = c.mode === "llm_host" ? c.iterations ?? defaultLlmIterations ?? 1 : c.iterations ?? 1;
+    const effectiveIterations = c.mode === "mcp_host" ? c.iterations ?? defaultLlmIterations ?? 1 : c.iterations ?? 1;
     const judgeReps = c.expect?.passesJudge != null ? c.expect.passesJudge.reps ?? c.judgeReps ?? defaultJudgeReps ?? 1 : 0;
     return sum + effectiveIterations * judgeReps;
   }, 0);
@@ -7026,12 +7049,12 @@ async function runEvalDataset(options, context) {
     );
   }
   const tasks = casesToRun.map((evalCase) => async () => {
-    const withIterations = evalCase.mode === "llm_host" && evalCase.iterations === void 0 && defaultLlmIterations !== void 0 ? { ...evalCase, iterations: defaultLlmIterations } : evalCase;
-    if (evalCase.mode === "llm_host") {
+    const withIterations = evalCase.mode === "mcp_host" && evalCase.iterations === void 0 && defaultLlmIterations !== void 0 ? { ...evalCase, iterations: defaultLlmIterations } : evalCase;
+    if (evalCase.mode === "mcp_host") {
       const effectiveIterations = withIterations.iterations ?? 1;
       if (effectiveIterations > 1 && effectiveIterations < 10) {
         console.warn(
-          `[mcp-server-tester] Eval case "${evalCase.id}": running ${effectiveIterations} iterations in llm_host mode may not be statistically reliable. Consider using 10+ iterations for accuracy measurements you can trust.`
+          `[mcp-server-tester] Eval case "${evalCase.id}": running ${effectiveIterations} iterations in mcp_host mode may not be statistically reliable. Consider using 10+ iterations for accuracy measurements you can trust.`
         );
       }
     }
@@ -7063,7 +7086,7 @@ async function runEvalDataset(options, context) {
     gitHash,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     packageVersion: package_default.version,
-    ...llmHostModel !== void 0 && { llmHostModel },
+    ...mcpHostModel !== void 0 && { mcpHostModel },
     ...judgeModel !== void 0 && { judgeModel }
   };
   const result = {
@@ -7108,12 +7131,12 @@ async function runEvalDataset(options, context) {
       );
     }
   }
-  const llmHostCases = caseResults.filter(
+  const mcpHostCases = caseResults.filter(
     (r) => r.toolPrecision !== void 0 || r.toolRecall !== void 0
   );
-  if (llmHostCases.length > 0) {
-    const avgPrec = llmHostCases.reduce((s, r) => s + (r.toolPrecision ?? 0), 0) / llmHostCases.length;
-    const avgRecall = llmHostCases.reduce((s, r) => s + (r.toolRecall ?? 0), 0) / llmHostCases.length;
+  if (mcpHostCases.length > 0) {
+    const avgPrec = mcpHostCases.reduce((s, r) => s + (r.toolPrecision ?? 0), 0) / mcpHostCases.length;
+    const avgRecall = mcpHostCases.reduce((s, r) => s + (r.toolRecall ?? 0), 0) / mcpHostCases.length;
     result.datasetToolPrecision = avgPrec;
     result.datasetToolRecall = avgRecall;
     result.datasetToolF1 = avgPrec + avgRecall > 0 ? 2 * avgPrec * avgRecall / (avgPrec + avgRecall) : 0;
@@ -7181,7 +7204,6 @@ async function runServerComparison(options, contextA, contextB) {
     bWins,
     ties,
     bothFail,
-    bothFailCount: bothFail,
     decidedCases,
     failureAlignment: total > 0 ? bothFail / total : 0,
     aWinRate: decidedCases > 0 ? aWins / decidedCases : 0,
@@ -7410,7 +7432,7 @@ exports.runEvalCase = runEvalCase;
 exports.runEvalDataset = runEvalDataset;
 exports.runServerComparison = runServerComparison;
 exports.saveBaseline = saveBaseline;
-exports.simulateLLMHost = simulateLLMHost;
+exports.simulateMCPHost = simulateMCPHost;
 exports.test = test;
 exports.validateAccessToken = validateAccessToken;
 exports.validateError = validateError;