@skyramp/mcp 0.2.8 → 0.2.150-rc.ldw

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,6 @@
 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];
+export declare function shouldInjectSkyrampBaseUrl(testType: TestType, contractMode?: ContractExecutionMode): boolean;
 export declare function registerExecuteSkyrampTestTool(server: McpServer): void;

package/build/tools/executeSkyrampTestTool.js

@@ -5,9 +5,13 @@ import { AnalyticsService } from "../services/AnalyticsService.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 { logger } from "../utils/logger.js";
 const TOOL_NAME = "skyramp_execute_test";
+export const CONTRACT_EXECUTION_MODES = ["provider", "consumer"];
+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.
@@ -53,10 +57,14 @@ For detailed documentation visit: https://www.skyramp.dev/docs/quickstart`,
                 .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."),
+                .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("ALWAYS USE 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()
                 .describe("Skyramp authentication token for test execution. USE EMPTY STRING WHEN USER CONFIRMS 'No token required'"),
@@ -81,46 +89,60 @@ For detailed documentation visit: https://www.skyramp.dev/docs/quickstart`,
             keywords: ["run test", "execute test"],
         },
     }, async (params, extra) => {
-        let errorResult;
-        // Helper to send progress notifications to the MCP client
+        // Helper to send progress notifications to the MCP client.
+        // Wrapped in try-catch so a broken/disconnected transport never crashes
+        // the tool handler or causes an unhandled rejection.
         const sendProgress = async (progress, total, message) => {
             const progressToken = extra._meta?.progressToken;
             if (progressToken !== undefined) {
-                const notification = {
-                    method: "notifications/progress",
-                    params: {
-                        progressToken,
-                        progress,
-                        total,
-                        message,
-                    },
-                };
-                await extra.sendNotification(notification);
+                try {
+                    const notification = {
+                        method: "notifications/progress",
+                        params: {
+                            progressToken,
+                            progress,
+                            total,
+                            message,
+                        },
+                    };
+                    await extra.sendNotification(notification);
+                }
+                catch {
+                    // Progress notifications are best-effort — swallow failures so
+                    // a flaky or disconnected transport doesn't kill the execution.
+                }
             }
         };
+        // Send immediate acknowledgment
+        await sendProgress(0, 100, "Starting execution...");
+        let errorResult;
         // 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 {
             // 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;
                     }
                     else if (candidates.length > 0) {
                         return {
-                            content: [{
+                            content: [
+                                {
                                     type: "text",
                                     text: [
                                         `Cannot determine SKYRAMP_TEST_BASE_URL — test file matches multiple services:`,
@@ -128,7 +150,8 @@ For detailed documentation visit: https://www.skyramp.dev/docs/quickstart`,
                                         ``,
                                         `Re-invoke with SKYRAMP_TEST_BASE_URL set to the correct service URL, or make each service's testDirectory unique in .skyramp/workspace.yml.`,
                                     ].join("\n"),
-                                }],
+                                },
+                            ],
                             isError: true,
                         };
                     }
@@ -146,7 +169,8 @@ For detailed documentation visit: https://www.skyramp.dev/docs/quickstart`,
                 testType: params.testType,
                 token: effectiveToken,
                 playwrightSaveStoragePath: params.playwrightSaveStoragePath,
-                useHostNetwork,
+                dockerNetwork,
+                useHostNetwork: false,
             }, onExecutionProgress);
             // Update stateFile with execution results if provided. Multi-repo: write
             // into the section for `repository` (primary when omitted/matching the

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

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

package/build/tools/executeSkyrampTestTool.test.js

@@ -0,0 +1,16 @@
+import { describe, expect, it } from "@jest/globals";
+import { TestType } from "../types/TestTypes.js";
+import { shouldInjectSkyrampBaseUrl } 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);
+    });
+});

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;