@skyramp/mcp 0.3.0 → 0.3.1-ldw-beta

package/build/tools/enrichTestWithMocksTool.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/enrichTestWithMocksTool.test.js

@@ -0,0 +1,266 @@
+import { describe, expect, it, beforeEach, afterEach } from "@jest/globals";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { injectMockImports } from "./enrichTestWithMocksTool.js";
+describe("injectMockImports", () => {
+    let tmpDir;
+    let testFile;
+    let mockFile;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "skyramp-enrich-"));
+        testFile = path.join(tmpDir, "account_integration_test.py");
+        mockFile = path.join(tmpDir, "billing_preferences_PUT_mock.py");
+        fs.writeFileSync(mockFile, [
+            "# Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "def get_all_mocks():",
+            "    return []",
+            "",
+        ].join("\n"));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("applies mocks in every Python test function", () => {
+        const source = [
+            "import skyramp",
+            "",
+            "def test_success():",
+            "    client = skyramp.Client(port=35142)",
+            "    assert True",
+            "",
+            "def test_error():",
+            "    client = skyramp.Client(",
+            "        port=35142,",
+            "    )",
+            "    assert True",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, testFile, "billing", [mockFile]);
+        expect(enriched.match(/^    apply_all_mocks\(client\)$/gm)).toHaveLength(2);
+        expect(enriched).toContain("MOCK_SERVICES");
+    });
+    it("does not duplicate apply calls when rerun", () => {
+        const source = [
+            "import skyramp",
+            "",
+            "def test_success():",
+            "    client = skyramp.Client(port=35142)",
+            "    assert True",
+            "",
+            "def test_error():",
+            "    client = skyramp.Client(port=35142)",
+            "    assert True",
+            "",
+        ].join("\n");
+        const once = injectMockImports(source, testFile, "billing", [mockFile]);
+        const twice = injectMockImports(once, testFile, "billing", [mockFile]);
+        expect(twice.match(/^    apply_all_mocks\(client\)$/gm)).toHaveLength(2);
+    });
+    it("wires TypeScript generated mocks into Playwright integration tests", () => {
+        const tsTestFile = path.join(tmpDir, "account_integration_test.spec.ts");
+        const tsMockFile = path.join(tmpDir, "billing_preferences_PUT_mock.ts");
+        fs.writeFileSync(tsMockFile, [
+            "// Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "function getAllMocks() {",
+            "    return [{ url: 'http://old-target' }];",
+            "}",
+            "async function main() {}",
+            "main().catch(err => {",
+            "    console.error(err);",
+            "    process.exit(1);",
+            "});",
+            "",
+        ].join("\n"));
+        const source = [
+            "import { test, SkyrampClient } from '@skyramp/skyramp';",
+            "",
+            "test('testIntegration', async () => {",
+            "    const client = new SkyrampClient();",
+            "    expect(true).toBe(true);",
+            "});",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, tsTestFile, "billing", [tsMockFile]);
+        const preparedMock = fs.readFileSync(tsMockFile, "utf-8");
+        expect(enriched).toContain("async function applyAllMocks(client: any)");
+        expect(enriched).toContain('module: billing_preferences_PUT_mock');
+        expect(enriched).toContain('importLabel: "./billing_preferences_PUT_mock"');
+        expect(enriched).toContain("service.importLabel ?? service.name");
+        expect(enriched).not.toContain("service.modulePath} does not export");
+        expect(enriched).toContain("await applyAllMocks(client);");
+        expect(enriched).toContain('"billing-preferences-PUT": "http://billing-service:4000"');
+        expect(preparedMock).toContain("export function getAllMocks(");
+        expect(preparedMock).toContain("skyramp-enrich disabled auto-apply");
+    });
+    it("wires JavaScript generated mocks into Playwright integration tests", () => {
+        const jsTestFile = path.join(tmpDir, "account_integration_test.spec.js");
+        const jsMockFile = path.join(tmpDir, "billing_preferences_PUT_mock.js");
+        fs.writeFileSync(jsMockFile, [
+            "// Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "function getAllMocks() {",
+            "    return [{ url: 'http://old-target' }];",
+            "}",
+            "async function main() {}",
+            "main().catch(err => {",
+            "    console.error(err);",
+            "    process.exit(1);",
+            "});",
+            "",
+        ].join("\n"));
+        const source = [
+            "const { test, SkyrampClient } = require('@skyramp/skyramp');",
+            "",
+            "test('testIntegration', async () => {",
+            "    const client = new SkyrampClient();",
+            "    expect(true).toBe(true);",
+            "});",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, jsTestFile, "billing", [jsMockFile]);
+        const preparedMock = fs.readFileSync(jsMockFile, "utf-8");
+        expect(enriched).toContain("async function applyAllMocks(client)");
+        expect(enriched).toContain('modulePath: "./billing_preferences_PUT_mock.js"');
+        expect(enriched).toContain('importLabel: "./billing_preferences_PUT_mock.js"');
+        expect(enriched).toContain("await applyAllMocks(client);");
+        expect(preparedMock).toContain("module.exports.getAllMocks = getAllMocks;");
+        expect(preparedMock).toContain("skyramp-enrich disabled auto-apply");
+    });
+    it("wires Java generated mocks into JUnit integration tests", () => {
+        const javaTestFile = path.join(tmpDir, "AccountIntegrationTest.java");
+        const javaMockDir = path.join(tmpDir, "mocks");
+        fs.mkdirSync(javaMockDir);
+        const javaMockFile = path.join(javaMockDir, "BillingPreferencesPutMock.java");
+        fs.writeFileSync(javaMockFile, [
+            "// Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "public final class BillingPreferencesPutMock {",
+            "    public List<MockV2> getAllMocks() { return List.of(); }",
+            "}",
+            "",
+        ].join("\n"));
+        const source = [
+            "import java.util.*;",
+            "import dev.skyramp.api.SkyrampClient;",
+            "import dev.skyramp.exception.SkyrampException;",
+            "import dev.skyramp.model.*;",
+            "",
+            "public final class AccountIntegrationTest {",
+            "    @Test",
+            "    public void testIntegration() throws SkyrampException {",
+            "        var client = new SkyrampClient();",
+            "        assertTrue(true);",
+            "    }",
+            "}",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, javaTestFile, "billing", [javaMockFile]);
+        expect(enriched).toContain("private static final List<String> MOCK_SERVICES = Arrays.asList(");
+        expect(enriched).toContain('        "BillingPreferencesPutMock"');
+        expect(enriched).toContain("private void applyAllMocks(SkyrampClient client) throws SkyrampException");
+        expect(enriched).toContain("List<MockV2> mocks0 = new BillingPreferencesPutMock().getAllMocks();");
+        expect(enriched).toContain('mock.setUrl("http://billing-service:4000");');
+        expect(enriched).toContain("        applyAllMocks(client);");
+    });
+    it("emits Python mock execution that clears, normalizes, then applies mocks", () => {
+        const source = [
+            "import skyramp",
+            "",
+            "def test_success():",
+            "    client = skyramp.Client(port=35142)",
+            "    assert True",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, testFile, "billing", [mockFile]);
+        expect(enriched).toContain("client.remove_all_mocks()");
+        expect(enriched).toContain("mock.url = target_url");
+        expect(enriched).toContain("client.apply_mock(all_mocks)");
+        expect(enriched.indexOf("client.remove_all_mocks()")).toBeLessThan(enriched.indexOf("client.apply_mock(all_mocks)"));
+    });
+    it("emits TypeScript mock execution that clears, normalizes, then applies mocks", () => {
+        const tsTestFile = path.join(tmpDir, "account_integration_test.spec.ts");
+        const tsMockFile = path.join(tmpDir, "billing_preferences_PUT_mock.ts");
+        fs.writeFileSync(tsMockFile, [
+            "// Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "function getAllMocks() { return [{ url: 'http://old-target' }]; }",
+            "main().catch((error) => {",
+            "    console.error(error);",
+            "    process.exit(1);",
+            "});",
+            "",
+        ].join("\n"));
+        const source = [
+            "import { test, SkyrampClient } from '@skyramp/skyramp';",
+            "test('testIntegration', async () => {",
+            "    const client = new SkyrampClient();",
+            "});",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, tsTestFile, "billing", [tsMockFile]);
+        const preparedMock = fs.readFileSync(tsMockFile, "utf-8");
+        expect(enriched).toContain("await client.removeAllMocks();");
+        expect(enriched).toContain("mock.url = targetUrl;");
+        expect(enriched).toContain("await client.applyMock(allMocks);");
+        expect(enriched.indexOf("await client.removeAllMocks();")).toBeLessThan(enriched.indexOf("await client.applyMock(allMocks);"));
+        expect(preparedMock).toContain("export function getAllMocks(");
+        expect(preparedMock).not.toContain("main().catch");
+    });
+    it("emits JavaScript mock execution that clears, normalizes, then applies mocks", () => {
+        const jsTestFile = path.join(tmpDir, "account_integration_test.spec.js");
+        const jsMockFile = path.join(tmpDir, "billing_preferences_PUT_mock.js");
+        fs.writeFileSync(jsMockFile, [
+            "// Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "function getAllMocks() { return [{ url: 'http://old-target' }]; }",
+            "main().catch(error => {",
+            "    console.error(error);",
+            "    process.exit(1);",
+            "});",
+            "",
+        ].join("\n"));
+        const source = [
+            "const { test, SkyrampClient } = require('@skyramp/skyramp');",
+            "test('testIntegration', async () => {",
+            "    const client = new SkyrampClient();",
+            "});",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, jsTestFile, "billing", [jsMockFile]);
+        const preparedMock = fs.readFileSync(jsMockFile, "utf-8");
+        expect(enriched).toContain("await client.removeAllMocks();");
+        expect(enriched).toContain("mock.url = targetUrl;");
+        expect(enriched).toContain("await client.applyMock(allMocks);");
+        expect(enriched.indexOf("await client.removeAllMocks();")).toBeLessThan(enriched.indexOf("await client.applyMock(allMocks);"));
+        expect(preparedMock).toContain("module.exports.getAllMocks = getAllMocks;");
+        expect(preparedMock).not.toContain("main().catch");
+    });
+    it("emits Java mock execution that clears, normalizes, then applies mocks", () => {
+        const javaTestFile = path.join(tmpDir, "AccountIntegrationTest.java");
+        const javaMockDir = path.join(tmpDir, "mocks");
+        fs.mkdirSync(javaMockDir);
+        const javaMockFile = path.join(javaMockDir, "BillingPreferencesPutMock.java");
+        fs.writeFileSync(javaMockFile, [
+            "// Command: skyramp generate mock rest http://billing-service:4000/v1/preferences --method PUT",
+            "public final class BillingPreferencesPutMock {",
+            "    public List<MockV2> getAllMocks() { return List.of(); }",
+            "}",
+            "",
+        ].join("\n"));
+        const source = [
+            "import java.util.*;",
+            "import dev.skyramp.api.SkyrampClient;",
+            "import dev.skyramp.exception.SkyrampException;",
+            "import dev.skyramp.model.*;",
+            "public final class AccountIntegrationTest {",
+            "    public void testIntegration() throws SkyrampException {",
+            "        var client = new SkyrampClient();",
+            "    }",
+            "}",
+            "",
+        ].join("\n");
+        const enriched = injectMockImports(source, javaTestFile, "billing", [javaMockFile]);
+        expect(enriched).toContain("private static final List<String> MOCK_SERVICES = Arrays.asList(");
+        expect(enriched).toContain("client.removeAllMocks();");
+        expect(enriched).toContain('mock.setUrl("http://billing-service:4000");');
+        expect(enriched).toContain("client.applyMock(allMocks);");
+        expect(enriched.indexOf("client.removeAllMocks();")).toBeLessThan(enriched.indexOf("client.applyMock(allMocks);"));
+    });
+});

package/build/tools/executeSkyrampTestTool.d.ts

@@ -1,2 +1,13 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TestType } from "../types/TestTypes.js";
+export declare const CONTRACT_EXECUTION_MODES: readonly ["provider", "consumer"];
+export type ContractExecutionMode = (typeof CONTRACT_EXECUTION_MODES)[number];
+/**
+ * Resolve the effective auth token for test execution.
+ * `unauthenticated: true` forces no token (empty string) so the container
+ * env omits SKYRAMP_TEST_TOKEN entirely — unauthenticated endpoints won't
+ * receive an empty Authorization header that triggers encoding errors (E7).
+ */
+export declare function resolveEffectiveToken(unauthenticated?: boolean, paramToken?: string, envToken?: string): string;
+export declare function shouldInjectSkyrampBaseUrl(testType: TestType, contractMode?: ContractExecutionMode): boolean;
 export declare function registerExecuteSkyrampTestTool(server: McpServer): void;

package/build/tools/executeSkyrampTestTool.js

@@ -7,11 +7,26 @@ import { makeProgressReporter } from "../utils/progress.js";
 import { TestExecutionStatus } from "../types/TestExecution.js";
 import { getWorkspaceBaseUrl } from "../utils/workspaceAuth.js";
 import { ProgrammingLanguage, TestType } from "../types/TestTypes.js";
-import { StateManager } from "../utils/AnalysisStateManager.js";
+import { StateManager, } from "../utils/AnalysisStateManager.js";
 import { TestSource } from "../types/TestAnalysis.js";
 import { logger } from "../utils/logger.js";
 import { toolError } from "../utils/utils.js";
 const TOOL_NAME = "skyramp_execute_test";
+export const CONTRACT_EXECUTION_MODES = ["provider", "consumer"];
+/**
+ * Resolve the effective auth token for test execution.
+ * `unauthenticated: true` forces no token (empty string) so the container
+ * env omits SKYRAMP_TEST_TOKEN entirely — unauthenticated endpoints won't
+ * receive an empty Authorization header that triggers encoding errors (E7).
+ */
+export function resolveEffectiveToken(unauthenticated, paramToken, envToken) {
+    if (unauthenticated)
+        return "";
+    return paramToken ?? envToken ?? "";
+}
+export function shouldInjectSkyrampBaseUrl(testType, contractMode) {
+    return testType !== TestType.CONTRACT || contractMode !== "consumer";
+}
 export function registerExecuteSkyrampTestTool(server) {
     server.registerTool(TOOL_NAME, {
         description: `Execute a Skyramp-generated test in isolated containerized environments for reliable, deterministic testing. Call this once a test file exists on disk (from a skyramp_*_test_generation tool). First-time execution may take longer while Docker images download — this is expected, not a failure.`,
@@ -30,10 +45,14 @@ export function registerExecuteSkyrampTestTool(server) {
                 .describe("Programming language of the test file to execute (e.g., python, javascript, typescript, java)"),
             testType: z
                 .nativeEnum(TestType)
-                .describe("Type of the test to execute (e.g., smoke, contract, fuzz, integration, load, ui, e2e)."),
+                .describe("Type of the test to execute. Note: 'mock' is NOT a valid test type — mock files are deployed via their apply_mock() function, not executed as tests."),
             testFile: z
                 .string()
                 .describe("Absolute path to the test file to execute."),
+            contractMode: z
+                .enum(CONTRACT_EXECUTION_MODES)
+                .optional()
+                .describe("Only applies when testType is 'contract'. Use 'provider' for provider contract tests that hit the real service under test and need SKYRAMP_TEST_BASE_URL. Use 'consumer' only for consumer contract tests with inline mocks that do not hit the real service. Defaults to provider behavior when omitted."),
             token: z
                 .string()
                 .optional()
@@ -64,15 +83,17 @@ export function registerExecuteSkyrampTestTool(server) {
         },
     }, async (params, extra) => {
         let errorResult;
-        // Helper to send progress notifications to the MCP client
+        // Helper to send progress notifications to the MCP client.
         const sendProgress = makeProgressReporter(extra);
+        // Send immediate acknowledgment
+        await sendProgress(0, 100, "Starting execution...");
         // Progress callback adapter for TestExecutionService
         const onExecutionProgress = async (progress) => {
             await sendProgress(progress.percent, 100, progress.message);
         };
         const previousBaseUrl = process.env.SKYRAMP_TEST_BASE_URL;
         let didSetSkyrampBaseUrl = false;
-        let useHostNetwork = false;
+        let dockerNetwork;
         try {
             if (!path.isAbsolute(params.testFile)) {
                 errorResult = toolError(`testFile must be an absolute path, got: ${params.testFile}`);
@@ -107,13 +128,16 @@ export function registerExecuteSkyrampTestTool(server) {
                 }
             }
             // Send initial progress
-            await sendProgress(0, 100, "Starting test execution...");
-            // Always resolve workspace config for dockerNetwork (host networking)
-            // and optionally inject SKYRAMP_TEST_BASE_URL if not already set.
+            await sendProgress(5, 100, "Starting test execution...");
+            // Resolve workspace config for base URL injection and Docker network
+            // attachment. A compose dockerNetwork is not host networking: on macOS
+            // the executor still needs localhost rewritten to host.docker.internal.
             if (params.workspacePath) {
-                const { baseUrl, dockerNetwork, candidates } = await getWorkspaceBaseUrl(params.workspacePath, params.testFile, params.language);
-                useHostNetwork = !!dockerNetwork;
-                if (!process.env.SKYRAMP_TEST_BASE_URL) {
+                const workspaceConfig = await getWorkspaceBaseUrl(params.workspacePath, params.testFile, params.language);
+                const { baseUrl, candidates } = workspaceConfig;
+                dockerNetwork = workspaceConfig.dockerNetwork;
+                const shouldInjectBaseUrl = shouldInjectSkyrampBaseUrl(params.testType, params.contractMode);
+                if (shouldInjectBaseUrl && !process.env.SKYRAMP_TEST_BASE_URL) {
                     if (baseUrl) {
                         process.env.SKYRAMP_TEST_BASE_URL = baseUrl;
                         didSetSkyrampBaseUrl = true;
@@ -130,24 +154,41 @@ export function registerExecuteSkyrampTestTool(server) {
                 }
             }
             const executionService = new TestExecutionService();
-            // `unauthenticated: true` forces no auth token regardless of what's passed or
-            // configured, so tests asserting 401/403 unauthenticated behavior can't be broken
-            // by an ambient SKYRAMP_TEST_TOKEN — see SKYR-3874. Otherwise fall back to the
-            // environment token when the caller omits `token`; this keeps secrets server-side
-            // and avoids embedding credential values in prompts.
-            const effectiveToken = params.unauthenticated
-                ? ""
-                : (params.token ?? process.env.SKYRAMP_TEST_TOKEN ?? "");
-            // Execute test with progress callback - reports Docker cache/pull status
-            const result = await executionService.executeTest({
+            const effectiveToken = resolveEffectiveToken(params.unauthenticated, params.token, process.env.SKYRAMP_TEST_TOKEN);
+            if (!effectiveToken && !params.unauthenticated && params.token === undefined) {
+                logger.warning("No auth token available — authenticated endpoints will likely return 401. Set SKYRAMP_TEST_TOKEN or pass token/unauthenticated.");
+            }
+            // Execute test with progress callback - reports Docker cache/pull status.
+            // Retry once on transient connection errors (EOF, connection refused) —
+            // these indicate the SUT isn't fully ready yet, not a test failure.
+            // Retrying inside the tool call saves agent turns vs failing and
+            // requiring the agent to re-invoke.
+            const execOptions = {
                 testFile: params.testFile,
                 workspacePath: params.workspacePath,
                 language: params.language,
                 testType: params.testType,
                 token: effectiveToken,
                 playwrightSaveStoragePath: params.playwrightSaveStoragePath,
-                useHostNetwork,
-            }, onExecutionProgress);
+                dockerNetwork,
+                useHostNetwork: false,
+            };
+            let result;
+            try {
+                result = await executionService.executeTest(execOptions, onExecutionProgress);
+            }
+            catch (firstErr) {
+                const errMsg = firstErr instanceof Error ? firstErr.message : String(firstErr);
+                if (/\bEOF\b|connection refused|ECONNREFUSED|ECONNRESET/i.test(errMsg)) {
+                    logger.info("Test execution hit transient connection error, retrying after 10s...", { error: errMsg });
+                    await sendProgress(50, 100, "SUT connection error — retrying in 10s...");
+                    await new Promise((r) => setTimeout(r, 10_000));
+                    result = await executionService.executeTest(execOptions, onExecutionProgress);
+                }
+                else {
+                    throw firstErr;
+                }
+            }
             // Update stateFile with execution results if provided. Multi-repo: write
             // into the section for `repository` (primary when omitted/matching the
             // root) of the run-scoped file.

package/build/tools/executeSkyrampTestTool.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/executeSkyrampTestTool.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from "@jest/globals";
+import { TestType } from "../types/TestTypes.js";
+import { shouldInjectSkyrampBaseUrl, resolveEffectiveToken, } from "./executeSkyrampTestTool.js";
+describe("shouldInjectSkyrampBaseUrl", () => {
+    it("injects for provider contract tests by default", () => {
+        expect(shouldInjectSkyrampBaseUrl(TestType.CONTRACT)).toBe(true);
+        expect(shouldInjectSkyrampBaseUrl(TestType.CONTRACT, "provider")).toBe(true);
+    });
+    it("skips injection only for explicit consumer contract tests", () => {
+        expect(shouldInjectSkyrampBaseUrl(TestType.CONTRACT, "consumer")).toBe(false);
+    });
+    it("injects for non-contract tests", () => {
+        expect(shouldInjectSkyrampBaseUrl(TestType.INTEGRATION, "consumer")).toBe(true);
+        expect(shouldInjectSkyrampBaseUrl(TestType.UI)).toBe(true);
+    });
+});
+describe("resolveEffectiveToken (E7: unauthenticated endpoint auth injection)", () => {
+    it("returns empty string when unauthenticated is true", () => {
+        expect(resolveEffectiveToken(true, "some-token", "env-token")).toBe("");
+    });
+    it("returns empty string when unauthenticated is true and no tokens exist", () => {
+        expect(resolveEffectiveToken(true, undefined, undefined)).toBe("");
+    });
+    it("uses param token over env token when authenticated", () => {
+        expect(resolveEffectiveToken(false, "param-token", "env-token")).toBe("param-token");
+    });
+    it("falls back to env token when param token is not provided", () => {
+        expect(resolveEffectiveToken(false, undefined, "env-token")).toBe("env-token");
+    });
+    it("returns empty string when no tokens are available and not unauthenticated", () => {
+        expect(resolveEffectiveToken(false, undefined, undefined)).toBe("");
+    });
+    it("returns empty string when unauthenticated is undefined and no tokens exist", () => {
+        expect(resolveEffectiveToken(undefined, undefined, undefined)).toBe("");
+    });
+});

package/build/tools/generate-tests/batchMockGenerationTool.d.ts

@@ -0,0 +1,85 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { MockProtocol } from "../../types/TestTypes.js";
+export { MockProtocol } from "../../types/TestTypes.js";
+export declare const BATCH_MOCK_PROTOCOL_EXAMPLES = "\n<example protocol=\"rest\">\nBatch REST item. Required fields: protocol=\"rest\", endpointURL, method unless apiSchema is provided.\n{\n  \"protocol\": \"rest\",\n  \"endpointURL\": \"http://identity-service:4000/api/internal/v1/users/validate\",\n  \"method\": \"POST\",\n  \"requestAware\": true,\n  \"responseData\": \"{\"valid\":true}\"\n}\n</example>\n\n<example protocol=\"grpc\">\nBatch gRPC item. Required fields: protocol=\"grpc\", endpointURL as host:port, protoPath, grpcServiceName. method is the RPC name; empty means all service methods.\n{\n  \"protocol\": \"grpc\",\n  \"endpointURL\": \"profile-service:50051\",\n  \"protoPath\": \"/repo/proto/profiles.proto\",\n  \"grpcServiceName\": \"ProfileService\",\n  \"method\": \"GetProfile\",\n  \"responseData\": \"{\"id\":\"profile_123\"}\"\n}\n</example>\n\n<example protocol=\"grpc-status-error\">\nBatch gRPC status error item. Do not provide responseData with grpcStatusCode.\n{\n  \"protocol\": \"grpc\",\n  \"endpointURL\": \"profile-service:50051\",\n  \"protoPath\": \"/repo/proto/profiles.proto\",\n  \"grpcServiceName\": \"ProfileService\",\n  \"method\": \"GetProfile\",\n  \"grpcStatusCode\": 5,\n  \"grpcStatusMessage\": \"profile not found\"\n}\n</example>\n\n<example protocol=\"kafka-producer\">\nBatch Kafka producer validation item. Required fields: protocol=\"kafka\", endpointURL as broker host:port, kafkaTopic, and requestData. Do not pass method or responseData.\n{\n  \"protocol\": \"kafka\",\n  \"endpointURL\": \"broker:9092\",\n  \"kafkaTopic\": \"orders\",\n  \"requestData\": \"{\"order_id\":\"ord_123\"}\"\n}\n</example>\n\n<example protocol=\"kafka-consumer\">\nBatch Kafka consumer message item. Required fields: protocol=\"kafka\", endpointURL as broker host:port, kafkaTopic, and responseData. Do not pass method or requestData.\n{\n  \"protocol\": \"kafka\",\n  \"endpointURL\": \"broker:9092\",\n  \"kafkaTopic\": \"orders\",\n  \"responseData\": \"{\"accepted\":true}\"\n}\n</example>";
+declare const mockSpecSchema: z.ZodObject<{
+    protocol: z.ZodDefault<z.ZodNativeEnum<typeof MockProtocol>>;
+    endpointURL: z.ZodString;
+    method: z.ZodDefault<z.ZodString>;
+    responseData: z.ZodOptional<z.ZodString>;
+    responseStatusCode: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
+    grpcStatusCode: z.ZodOptional<z.ZodNumber>;
+    grpcStatusMessage: z.ZodOptional<z.ZodString>;
+    requestData: z.ZodDefault<z.ZodString>;
+    requestAware: z.ZodDefault<z.ZodBoolean>;
+    apiSchema: z.ZodDefault<z.ZodString>;
+    protoPath: z.ZodOptional<z.ZodString>;
+    grpcServiceName: z.ZodOptional<z.ZodString>;
+    protobufExtraFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    protobufExtraImportPath: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    kafkaTopic: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    method: string;
+    endpointURL: string;
+    apiSchema: string;
+    requestData: string;
+    responseStatusCode: string;
+    protocol: MockProtocol;
+    requestAware: boolean;
+    output?: string | undefined;
+    outputDir?: string | undefined;
+    responseData?: string | undefined;
+    protoPath?: string | undefined;
+    grpcServiceName?: string | undefined;
+    protobufExtraFiles?: string[] | undefined;
+    protobufExtraImportPath?: string[] | undefined;
+    kafkaTopic?: string | undefined;
+    grpcStatusCode?: number | undefined;
+    grpcStatusMessage?: string | undefined;
+}, {
+    endpointURL: string;
+    output?: string | undefined;
+    outputDir?: string | undefined;
+    method?: string | undefined;
+    apiSchema?: string | undefined;
+    requestData?: string | undefined;
+    responseStatusCode?: string | undefined;
+    responseData?: string | undefined;
+    protocol?: MockProtocol | undefined;
+    protoPath?: string | undefined;
+    grpcServiceName?: string | undefined;
+    protobufExtraFiles?: string[] | undefined;
+    protobufExtraImportPath?: string[] | undefined;
+    kafkaTopic?: string | undefined;
+    grpcStatusCode?: number | undefined;
+    grpcStatusMessage?: string | undefined;
+    requestAware?: boolean | undefined;
+}>;
+export type MockSpec = z.infer<typeof mockSpecSchema>;
+export type MockSpecInput = z.input<typeof mockSpecSchema>;
+export interface BatchMockResult {
+    index: number;
+    protocol: string;
+    endpointURL: string;
+    method: string;
+    topic?: string;
+    success: boolean;
+    outputDir?: string;
+    output?: string;
+    error?: string;
+    detail?: string;
+}
+export interface BatchMockParams {
+    mocks: MockSpecInput[];
+    outputDir: string;
+    runtime?: string;
+    dockerNetwork?: string;
+    language?: string;
+    framework?: string;
+}
+export declare function executeBatchMockGeneration(params: BatchMockParams): Promise<CallToolResult>;
+export declare function registerBatchMockTool(server: McpServer): void;