@muggleai/mcp-qa-gateway 1.0.1

package/dist/src/tools/tool-registry.js

@@ -0,0 +1,1142 @@
+"use strict";
+/**
+ * Tool registry for MCP QA Gateway.
+ * Maps tool names to their implementations and upstream API calls.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allTools = void 0;
+exports.getToolByName = getToolByName;
+exports.executeTool = executeTool;
+const index_js_1 = require("../config/index.js");
+const prompt_service_client_js_1 = require("../upstream/prompt-service-client.js");
+const constants_js_1 = require("./constants.js");
+const schemas = __importStar(require("./schemas.js"));
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Default response mapper (pass through data).
+ */
+function defaultResponseMapper(response) {
+    return response.data;
+}
+// =============================================================================
+// Project Tools
+// =============================================================================
+const projectTools = [
+    {
+        name: "qa_project_create",
+        description: "Create a new QA testing project. Projects organize use cases, test cases, and test scripts.",
+        inputSchema: schemas.ProjectCreateInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects`,
+                body: {
+                    name: data.projectName,
+                    description: data.description,
+                    url: data.url,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_project_get",
+        description: "Get details of a specific project by ID.",
+        inputSchema: schemas.ProjectGetInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}`,
+            };
+        },
+    },
+    {
+        name: "qa_project_update",
+        description: "Update an existing project's details.",
+        inputSchema: schemas.ProjectUpdateInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            const body = {
+                id: data.projectId,
+            };
+            if (data.projectName !== undefined)
+                body.name = data.projectName;
+            if (data.description !== undefined)
+                body.description = data.description;
+            if (data.url !== undefined)
+                body.url = data.url;
+            return {
+                method: "PUT",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}`,
+                body: body,
+            };
+        },
+    },
+    {
+        name: "qa_project_list",
+        description: "List all projects accessible to the authenticated user.",
+        inputSchema: schemas.ProjectListInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects`,
+                queryParams: {
+                    page: data.page,
+                    pageSize: data.pageSize,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_project_delete",
+        description: "Delete a project and all associated entities (use cases, test cases, test scripts). This is a soft delete.",
+        inputSchema: schemas.ProjectDeleteInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "DELETE",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}`,
+            };
+        },
+    },
+];
+// =============================================================================
+// PRD File Tools
+// =============================================================================
+const prdFileTools = [
+    {
+        name: "qa_prd_file_upload",
+        description: "Upload a PRD (Product Requirements Document) file to a project. The file content should be base64-encoded.",
+        inputSchema: schemas.PrdFileUploadInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/use-case/prd-file-upload`,
+                multipartFormData: {
+                    fileFieldName: "file",
+                    fileName: data.fileName,
+                    contentType: data.contentType || "application/octet-stream",
+                    fileBase64: data.contentBase64,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_prd_file_list_by_project",
+        description: "List all PRD files associated with a project.",
+        inputSchema: schemas.PrdFileListInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/prd-files`,
+            };
+        },
+    },
+    {
+        name: "qa_prd_file_delete",
+        description: "Delete a PRD file from a project.",
+        inputSchema: schemas.PrdFileDeleteInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "DELETE",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/prd-files/${data.prdFileId}`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_start_prd_file_process",
+        description: "Start a PRD file processing workflow to extract use cases from uploaded PRD documents. Requires the prdFilePath, contentChecksum, and fileSize from the upload response.",
+        inputSchema: schemas.PrdFileProcessStartInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/use-case/prd-file-process`,
+                body: {
+                    projectId: data.projectId,
+                    name: data.name,
+                    description: data.description,
+                    prdFilePath: data.prdFilePath,
+                    originalFileName: data.originalFileName,
+                    url: data.url,
+                    contentChecksum: data.contentChecksum,
+                    fileSize: data.fileSize,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_prd_file_process_latest_run",
+        description: "Get the latest run status of a PRD file processing workflow.",
+        inputSchema: schemas.PrdFileProcessLatestRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/use-case/prd-file-process/${data.workflowRuntimeId}/run/latest`,
+            };
+        },
+    },
+];
+// =============================================================================
+// Secret Tools
+// =============================================================================
+const secretTools = [
+    {
+        name: "qa_secret_list",
+        description: "List all secrets (credentials) for a project. Secret values are not returned for security.",
+        inputSchema: schemas.SecretListInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/secrets`,
+                queryParams: { projectId: data.projectId },
+            };
+        },
+    },
+    {
+        name: "qa_secret_create",
+        description: "Create a new secret (credential) for a project. Secrets can be used in test workflows.",
+        inputSchema: schemas.SecretCreateInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/secrets`,
+                body: {
+                    projectId: data.projectId,
+                    name: data.name,
+                    value: data.value,
+                    description: data.description,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_secret_get",
+        description: "Get details of a specific secret by ID. The secret value is not returned for security.",
+        inputSchema: schemas.SecretGetInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/secrets/${data.secretId}`,
+            };
+        },
+    },
+    {
+        name: "qa_secret_update",
+        description: "Update an existing secret.",
+        inputSchema: schemas.SecretUpdateInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            const body = {};
+            if (data.name !== undefined)
+                body.name = data.name;
+            if (data.value !== undefined)
+                body.value = data.value;
+            if (data.description !== undefined)
+                body.description = data.description;
+            return {
+                method: "PUT",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/secrets/${data.secretId}`,
+                body: body,
+            };
+        },
+    },
+    {
+        name: "qa_secret_delete",
+        description: "Delete a secret from a project.",
+        inputSchema: schemas.SecretDeleteInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "DELETE",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/secrets/${data.secretId}`,
+            };
+        },
+    },
+];
+// =============================================================================
+// Use Case Tools
+// =============================================================================
+const useCaseTools = [
+    {
+        name: "qa_use_case_discovery_memory_get",
+        description: "Get the use case discovery memory for a project, including all discovered use case candidates with their status, evidence (screenshots, notes), and evaluation scores.",
+        inputSchema: schemas.UseCaseDiscoveryMemoryGetInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/use-case-discovery-memory`,
+            };
+        },
+    },
+    {
+        name: "qa_use_case_candidates_approve",
+        description: "Approve (graduate) selected use case candidates into actual use cases. This promotes candidates from 'candidate' status to 'graduated' status.",
+        inputSchema: schemas.UseCaseCandidatesApproveInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/use-case-discovery-memory/graduate`,
+                body: {
+                    approveIds: data.approvedCandidateIds,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_use_case_list",
+        description: "List all use cases for a project.",
+        inputSchema: schemas.UseCaseListInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/use-cases`,
+                queryParams: {
+                    projectId: data.projectId,
+                    page: data.page,
+                    pageSize: data.pageSize,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_use_case_get",
+        description: "Get details of a specific use case by ID.",
+        inputSchema: schemas.UseCaseGetInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/use-cases/${data.useCaseId}`,
+            };
+        },
+    },
+    {
+        name: "qa_use_case_prompt_preview",
+        description: "Preview a use case generated from a natural language instruction without saving. Returns a complete use case structure including title, user story, description, and breakdown items that can be reviewed before creation.",
+        inputSchema: schemas.UseCasePromptPreviewInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/use-cases/prompt/preview`,
+                body: {
+                    instruction: data.instruction,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_use_case_create_from_prompts",
+        description: "Create one or more use cases from natural language instructions. Each prompt generates a use case with title, user story, description, and breakdown items. After creation, test case detection workflows are automatically triggered.",
+        inputSchema: schemas.UseCaseCreateFromPromptsInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/use-cases/prompts/bulk`,
+                body: {
+                    projectId: data.projectId,
+                    prompts: data.prompts,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_use_case_update_from_prompt",
+        description: "Update an existing use case by regenerating its fields from a new natural language instruction. This replaces the title, user story, description, and breakdown items, then triggers test case detection workflows.",
+        inputSchema: schemas.UseCaseUpdateFromPromptInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/use-cases/${data.useCaseId}/prompt`,
+                body: {
+                    instruction: data.instruction,
+                },
+            };
+        },
+    },
+];
+// =============================================================================
+// Workflow Tools
+// =============================================================================
+const config = (0, index_js_1.getConfig)();
+const workflowTools = [
+    {
+        name: "qa_workflow_start_website_scan",
+        description: "Start a website scan workflow to discover use cases from a URL. This crawls the website and proposes use case candidates based on the site structure and content.",
+        inputSchema: schemas.WorkflowStartWebsiteScanInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/use-case/website-scan`,
+                body: {
+                    projectId: data.projectId,
+                    url: data.url,
+                    description: data.description,
+                    archiveUnapproved: data.archiveUnapproved,
+                },
+                timeoutMs: config.workflowTimeoutMs,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_list_website_scan_runtimes",
+        description: "List website scan workflow runtimes, optionally filtered by project.",
+        inputSchema: schemas.WorkflowListRuntimesInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/use-case/website-scan/workflowRuntimes`,
+                queryParams: { projectId: data.projectId },
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_website_scan_latest_run",
+        description: "Get the latest run status for a website scan workflow runtime.",
+        inputSchema: schemas.WorkflowGetLatestRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/use-case/website-scan/${data.workflowRuntimeId}/run/latest`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_start_test_case_detection",
+        description: "Start a test case detection workflow to generate test cases from approved use cases.",
+        inputSchema: schemas.WorkflowStartTestCaseDetectionInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-case/test-case-detection`,
+                body: {
+                    projectId: data.projectId,
+                    useCaseId: data.useCaseId,
+                    name: data.name,
+                    description: data.description,
+                    url: data.url,
+                },
+                timeoutMs: config.workflowTimeoutMs,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_list_test_case_detection_runtimes",
+        description: "List test case detection workflow runtimes.",
+        inputSchema: schemas.WorkflowListRuntimesInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-case/test-case-detection/workflowRuntimes`,
+                queryParams: { projectId: data.projectId },
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_test_case_detection_latest_run",
+        description: "Get the latest run status for a test case detection workflow runtime.",
+        inputSchema: schemas.WorkflowGetLatestRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-case/test-case-detection/${data.workflowRuntimeId}/run/latest`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_start_test_script_generation",
+        description: "Start a test script generation workflow to generate executable test scripts from test cases.",
+        inputSchema: schemas.WorkflowStartTestScriptGenerationInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-generation`,
+                body: {
+                    projectId: data.projectId,
+                    testCaseId: data.testCaseId,
+                    useCaseId: data.useCaseId,
+                    name: data.name,
+                    url: data.url,
+                    goal: data.goal,
+                    precondition: data.precondition,
+                    instructions: data.instructions,
+                    expectedResult: data.expectedResult,
+                },
+                timeoutMs: config.workflowTimeoutMs,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_test_script_generation_latest_run",
+        description: "Get the latest run status for a test script generation workflow runtime.",
+        inputSchema: schemas.WorkflowGetLatestRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-generation/${data.workflowRuntimeId}/run/latest`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_latest_test_script_generation_runtime_by_test_case",
+        description: "Get the latest test script generation runtime for a specific test case.",
+        inputSchema: schemas.WorkflowGetLatestScriptGenByTestCaseInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-generation/testcases/${data.testCaseId}/runtime/latest`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_start_test_script_replay",
+        description: "Start a test script replay workflow to execute a single test script.",
+        inputSchema: schemas.WorkflowStartTestScriptReplayInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-replay`,
+                body: {
+                    projectId: data.projectId,
+                    useCaseId: data.useCaseId,
+                    testCaseId: data.testCaseId,
+                    testScriptId: data.testScriptId,
+                    name: data.name,
+                },
+                timeoutMs: config.workflowTimeoutMs,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_test_script_replay_latest_run",
+        description: "Get the latest run status for a test script replay workflow runtime.",
+        inputSchema: schemas.WorkflowGetLatestRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-replay/${data.workflowRuntimeId}/run/latest`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_start_test_script_replay_bulk",
+        description: "Start a bulk test script replay workflow to execute multiple test scripts in parallel.",
+        inputSchema: schemas.WorkflowStartTestScriptReplayBulkInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-replay/bulk/workflowRuntimes`,
+                body: {
+                    projectId: data.projectId,
+                    name: data.name,
+                    intervalSec: data.intervalSec,
+                    useCaseId: data.useCaseId,
+                    namePrefix: data.namePrefix,
+                    limit: data.limit,
+                    testCaseIds: data.testCaseIds,
+                    repeatPerTestCase: data.repeatPerTestCase,
+                },
+                timeoutMs: config.workflowTimeoutMs,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_list_test_script_replay_bulk_runtimes",
+        description: "List bulk test script replay workflow runtimes.",
+        inputSchema: schemas.WorkflowListRuntimesInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-replay/bulk/workflowRuntimes`,
+                queryParams: { projectId: data.projectId },
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_test_script_replay_bulk_latest_run",
+        description: "Get the latest run status for a bulk test script replay workflow runtime.",
+        inputSchema: schemas.WorkflowGetLatestRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-replay/bulk/${data.workflowRuntimeId}/run/latest`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_get_replay_bulk_run_batch_summary",
+        description: "Get the summary of a bulk replay run batch, including pass/fail counts and individual results.",
+        inputSchema: schemas.WorkflowGetReplayBulkBatchSummaryInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-replay/bulk/run-batch/${data.runBatchId}/summary`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_cancel_run",
+        description: "Cancel a running workflow run.",
+        inputSchema: schemas.WorkflowCancelRunInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/runs/${data.workflowRunId}/cancel`,
+            };
+        },
+    },
+    {
+        name: "qa_workflow_cancel_runtime",
+        description: "Cancel a workflow runtime and all its runs.",
+        inputSchema: schemas.WorkflowCancelRuntimeInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/workflow/runtimes/${data.workflowRuntimeId}/cancel`,
+            };
+        },
+    },
+];
+// =============================================================================
+// Artifact Inspection Tools (Test Cases, Scripts, Summaries)
+// =============================================================================
+const artifactTools = [
+    {
+        name: "qa_test_case_list",
+        description: "List test cases for a project.",
+        inputSchema: schemas.TestCaseListInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/test-cases`,
+                queryParams: {
+                    projectId: data.projectId,
+                    page: data.page,
+                    pageSize: data.pageSize,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_test_case_get",
+        description: "Get details of a specific test case, including steps and expected outcomes.",
+        inputSchema: schemas.TestCaseGetInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/test-cases/${data.testCaseId}`,
+            };
+        },
+    },
+    {
+        name: "qa_test_case_list_by_use_case",
+        description: "List test cases for a specific use case.",
+        inputSchema: schemas.TestCaseListByUseCaseInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/use-cases/${data.useCaseId}/test-cases`,
+            };
+        },
+    },
+    {
+        name: "qa_test_case_generate_from_prompt",
+        description: "Generate one or more test cases from a natural language prompt. " +
+            "Requires project and use case context. Returns preview test cases " +
+            "(not persisted) that can be reviewed and then created using qa_test_case_create.",
+        inputSchema: schemas.TestCaseGenerateFromPromptInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/use-cases/${data.useCaseId}/test-cases/prompt/preview`,
+                body: {
+                    instruction: data.instruction,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_test_case_create",
+        description: "Create a new test case for a use case. Use this to persist test cases " +
+            "after reviewing previews from qa_test_case_generate_from_prompt.",
+        inputSchema: schemas.TestCaseCreateInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/test-cases`,
+                body: {
+                    projectId: data.projectId,
+                    useCaseId: data.useCaseId,
+                    title: data.title,
+                    description: data.description,
+                    goal: data.goal,
+                    precondition: data.precondition,
+                    expectedResult: data.expectedResult,
+                    url: data.url,
+                    status: data.status || "DRAFT",
+                    priority: data.priority || "MEDIUM",
+                    tags: data.tags || [],
+                    category: data.category || "Functional",
+                    automated: data.automated ?? true,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_test_script_list",
+        description: "List test scripts for a project.",
+        inputSchema: schemas.TestScriptListInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/test-scripts`,
+                queryParams: {
+                    projectId: data.projectId,
+                    page: data.page,
+                    pageSize: data.pageSize,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_test_script_get",
+        description: "Get details of a specific test script, including executable steps and screenshots.",
+        inputSchema: schemas.TestScriptGetInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/test-scripts/${data.testScriptId}`,
+            };
+        },
+    },
+    {
+        name: "qa_test_script_list_paginated",
+        description: "List test scripts with full pagination support.",
+        inputSchema: schemas.TestScriptListPaginatedInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/test-scripts/paginated`,
+                queryParams: {
+                    projectId: data.projectId,
+                    page: data.page,
+                    pageSize: data.pageSize,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_project_test_results_summary_get",
+        description: "Get a summary of test results for a project, including pass/fail counts and trends.",
+        inputSchema: schemas.ProjectTestResultsSummaryInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/testResults`,
+            };
+        },
+    },
+    {
+        name: "qa_project_test_scripts_summary_get",
+        description: "Get a summary of test scripts for a project.",
+        inputSchema: schemas.ProjectTestScriptsSummaryInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/test-scripts/summary`,
+            };
+        },
+    },
+    {
+        name: "qa_project_test_runs_summary_get",
+        description: "Get a summary of test runs for a project, including recent execution history.",
+        inputSchema: schemas.ProjectTestRunsSummaryInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/projects/${data.projectId}/test-runs/summary`,
+            };
+        },
+    },
+];
+// =============================================================================
+// Report Tools
+// =============================================================================
+const reportTools = [
+    {
+        name: "qa_report_stats_summary_get",
+        description: "Get report statistics summary for a project, including health score and key metrics.",
+        inputSchema: schemas.ReportStatsSummaryInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "GET",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/report/stats-summary`,
+                queryParams: { projectId: data.projectId },
+            };
+        },
+    },
+    {
+        name: "qa_report_cost_query",
+        description: "Query cost/usage data for a project over a date range.",
+        inputSchema: schemas.ReportCostQueryInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/report/cost/query`,
+                body: {
+                    projectId: data.projectId,
+                    startDateKey: data.startDateKey,
+                    endDateKey: data.endDateKey,
+                    filterType: data.filterType,
+                    filterIds: data.filterIds,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_report_preferences_upsert",
+        description: "Update report delivery preferences for a project. Configure email, SMS, or webhook delivery channels.",
+        inputSchema: schemas.ReportPreferencesUpsertInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "PUT",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/report/preferences`,
+                body: {
+                    projectId: data.projectId,
+                    channels: data.channels,
+                    emails: data.emails,
+                    phones: data.phones,
+                    webhookUrl: data.webhookUrl,
+                    defaultExportFormat: data.defaultExportFormat,
+                },
+            };
+        },
+    },
+    {
+        name: "qa_report_final_generate",
+        description: "Generate a final test report for a project. Returns a workflow runtime ID that can be polled for completion.",
+        inputSchema: schemas.ReportFinalGenerateInputSchema,
+        mapToUpstream: (input) => {
+            const data = input;
+            return {
+                method: "POST",
+                path: `${constants_js_1.MUGGLE_TEST_PREFIX}/report/final/generate`,
+                body: {
+                    projectId: data.projectId,
+                    exportFormat: data.exportFormat,
+                },
+                timeoutMs: config.workflowTimeoutMs,
+            };
+        },
+    },
+];
+// =============================================================================
+// Recommendation Tools (No Side Effects)
+// =============================================================================
+const recommendationTools = [
+    {
+        name: "qa_recommend_schedule",
+        description: "Get recommendations for test scheduling based on project needs. This tool provides guidance only and does not create schedules.",
+        inputSchema: schemas.RecommendScheduleInputSchema,
+        mapToUpstream: () => {
+            // This tool returns static recommendations, no upstream call needed
+            throw new Error("RECOMMENDATION_ONLY");
+        },
+        mapFromUpstream: () => {
+            return {
+                recommendations: [
+                    {
+                        title: "Nightly Regression Tests",
+                        rationale: "Running tests every night catches regressions quickly while minimizing CI resource usage during peak development hours.",
+                        schedule: "0 2 * * *",
+                        timezone: "UTC",
+                        tradeoffs: [
+                            "Pro: Catches issues overnight, fresh results every morning",
+                            "Pro: Lower CI costs than running on every commit",
+                            "Con: Issues discovered after developer context is lost",
+                        ],
+                    },
+                    {
+                        title: "On-Demand with Smoke Tests",
+                        rationale: "Run a quick smoke test on every PR, with full regression on merge to main.",
+                        schedule: "Pull Request trigger + main branch merge",
+                        tradeoffs: [
+                            "Pro: Fast feedback on PRs",
+                            "Pro: Full coverage before release",
+                            "Con: Requires good smoke test selection",
+                        ],
+                    },
+                    {
+                        title: "Continuous Monitoring",
+                        rationale: "Run tests every 4 hours for production monitoring of critical flows.",
+                        schedule: "0 */4 * * *",
+                        tradeoffs: [
+                            "Pro: Quick detection of production issues",
+                            "Con: Higher resource usage",
+                            "Con: May generate noise if tests are flaky",
+                        ],
+                    },
+                ],
+            };
+        },
+    },
+    {
+        name: "qa_recommend_cicd_setup",
+        description: "Get recommendations and templates for CI/CD integration. This tool provides guidance and sample YAML configurations only.",
+        inputSchema: schemas.RecommendCicdSetupInputSchema,
+        mapToUpstream: () => {
+            throw new Error("RECOMMENDATION_ONLY");
+        },
+        mapFromUpstream: (_response, input) => {
+            const data = input;
+            const provider = data?.repositoryProvider || "github";
+            const cadence = data?.cadence || "onPullRequest";
+            const recommendations = [];
+            if (provider === "github" || provider === "other") {
+                recommendations.push({
+                    title: "GitHub Actions Integration",
+                    rationale: "Native GitHub integration with minimal setup. Uses workflow dispatch for on-demand triggers.",
+                    steps: [
+                        "Create .github/workflows/muggle-test.yml in your repository",
+                        "Add your Muggle AI API key as a repository secret (MUGGLE_AI_API_KEY)",
+                        "Configure the workflow trigger based on your cadence preference",
+                        "Optionally add status checks to require passing tests for PR merge",
+                    ],
+                    sampleYaml: cadence === "onPullRequest"
+                        ? `name: Muggle AI Tests
+on:
+  pull_request:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Muggle AI Tests
+        run: |
+          curl -X POST "https://mcp-qa-gateway.muggle-ai.com/trigger" \\
+            -H "x-api-key: \${{ secrets.MUGGLE_AI_API_KEY }}" \\
+            -H "Content-Type: application/json" \\
+            -d '{"projectId": "\${{ vars.MUGGLE_PROJECT_ID }}"}'`
+                        : `name: Muggle AI Nightly Tests
+on:
+  schedule:
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Muggle AI Tests
+        run: |
+          curl -X POST "https://mcp-qa-gateway.muggle-ai.com/trigger" \\
+            -H "x-api-key: \${{ secrets.MUGGLE_AI_API_KEY }}" \\
+            -H "Content-Type: application/json" \\
+            -d '{"projectId": "\${{ vars.MUGGLE_PROJECT_ID }}"}'`,
+                });
+            }
+            if (provider === "azureDevOps" || provider === "other") {
+                recommendations.push({
+                    title: "Azure DevOps Pipelines Integration",
+                    rationale: "Native Azure DevOps integration with pipeline triggers and variable groups.",
+                    steps: [
+                        "Create azure-pipelines.yml in your repository root",
+                        "Add MUGGLE_AI_API_KEY to a variable group or pipeline variables",
+                        "Configure triggers based on your cadence preference",
+                        "Add branch policies to require passing tests",
+                    ],
+                    sampleYaml: `trigger:
+  - main
+  - master
+
+schedules:
+  - cron: '0 2 * * *'
+    displayName: Nightly Tests
+    branches:
+      include:
+        - main
+
+pool:
+  vmImage: 'ubuntu-latest'
+
+steps:
+  - script: |
+      curl -X POST "https://mcp-qa-gateway.muggle-ai.com/trigger" \\
+        -H "x-api-key: $(MUGGLE_AI_API_KEY)" \\
+        -H "Content-Type: application/json" \\
+        -d '{"projectId": "$(MUGGLE_PROJECT_ID)}"'
+    displayName: 'Trigger Muggle AI Tests'`,
+                });
+            }
+            if (provider === "gitlab" || provider === "other") {
+                recommendations.push({
+                    title: "GitLab CI Integration",
+                    rationale: "Native GitLab CI integration with merge request pipelines.",
+                    steps: [
+                        "Add .gitlab-ci.yml to your repository",
+                        "Add MUGGLE_AI_API_KEY as a CI/CD variable (masked)",
+                        "Configure pipeline rules based on your cadence",
+                    ],
+                    sampleYaml: `stages:
+  - test
+
+muggle-ai-tests:
+  stage: test
+  image: curlimages/curl:latest
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_PIPELINE_SOURCE == "schedule"
+  script:
+    - |
+      curl -X POST "https://mcp-qa-gateway.muggle-ai.com/trigger" \\
+        -H "x-api-key: $MUGGLE_AI_API_KEY" \\
+        -H "Content-Type: application/json" \\
+        -d '{"projectId": "'$MUGGLE_PROJECT_ID'"}'`,
+                });
+            }
+            return { recommendations: recommendations };
+        },
+    },
+];
+// =============================================================================
+// Tool Registry
+// =============================================================================
+/**
+ * All registered tools.
+ */
+exports.allTools = [
+    ...projectTools,
+    ...prdFileTools,
+    ...secretTools,
+    ...useCaseTools,
+    ...workflowTools,
+    ...artifactTools,
+    ...reportTools,
+    ...recommendationTools,
+];
+/**
+ * Get a tool definition by name.
+ * @param name - Tool name.
+ * @returns Tool definition or undefined.
+ */
+function getToolByName(name) {
+    return exports.allTools.find((tool) => tool.name === name);
+}
+/**
+ * Execute a tool with the given input.
+ * @param toolName - Name of the tool to execute.
+ * @param input - Tool input (will be validated).
+ * @param credentials - Caller credentials.
+ * @param correlationId - Request correlation ID.
+ * @returns Tool output.
+ */
+async function executeTool(toolName, input, credentials, correlationId) {
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    // Validate input
+    const validatedInput = tool.inputSchema.parse(input);
+    // Check if this is a recommendation-only tool
+    try {
+        const upstreamCall = tool.mapToUpstream(validatedInput);
+        // Execute upstream call
+        const client = (0, prompt_service_client_js_1.getPromptServiceClient)();
+        const response = await client.execute(upstreamCall, credentials, correlationId);
+        // Map response
+        const mapper = tool.mapFromUpstream || defaultResponseMapper;
+        return mapper(response);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === "RECOMMENDATION_ONLY") {
+            // This is a recommendation tool, return static response
+            const mapper = tool.mapFromUpstream || defaultResponseMapper;
+            return mapper({ statusCode: 200, data: {}, headers: {} }, validatedInput);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=tool-registry.js.map