@perfai/mcp 1.0.24

package/dist/tools/protected/listApis.d.ts

@@ -0,0 +1,28 @@
+export declare const listApisTool: {
+    readonly name: "list_apps";
+    readonly description: "📋 List all apps in table format (Seq, App Name, Label) - supports filtering by name, environment, and pagination (requires authentication)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly search: {
+                readonly type: "string";
+                readonly description: "Filter apps by name or label (optional)";
+            };
+            readonly environment: {
+                readonly type: "string";
+                readonly description: "Filter by environment e.g. 'production', 'staging' (optional)";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly description: "Page number for pagination (default: 1)";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Number of apps per page (default: 50, max: 200)";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+export declare function handleListApis(authManager: any, args?: any): Promise<any>;
+//# sourceMappingURL=listApis.d.ts.map

package/dist/tools/protected/listApis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listApis.d.ts","sourceRoot":"","sources":["../../../src/tools/protected/listApis.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAyBf,CAAC;AAEX,wBAAsB,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAoFnF"}

package/dist/tools/protected/listApis.js

@@ -0,0 +1,102 @@
+import axios from "axios";
+import { API_ENDPOINTS } from "../../config.js";
+import { formatAppList } from "../../utils/formatters.js";
+export const listApisTool = {
+    name: "list_apps",
+    description: "📋 List all apps in table format (Seq, App Name, Label) - supports filtering by name, environment, and pagination (requires authentication)",
+    inputSchema: {
+        type: "object",
+        properties: {
+            search: {
+                type: "string",
+                description: "Filter apps by name or label (optional)"
+            },
+            environment: {
+                type: "string",
+                description: "Filter by environment e.g. 'production', 'staging' (optional)"
+            },
+            page: {
+                type: "number",
+                description: "Page number for pagination (default: 1)"
+            },
+            limit: {
+                type: "number",
+                description: "Number of apps per page (default: 50, max: 200)"
+            }
+        },
+        additionalProperties: false,
+    },
+};
+export async function handleListApis(authManager, args = {}) {
+    try {
+        const accessToken = authManager.getAccessToken();
+        const tokenType = authManager.getTokenType();
+        const orgId = authManager.getSelectedOrgId();
+        const search = args.search?.trim();
+        const environment = args.environment?.trim();
+        const page = args.page && args.page >= 1 ? Math.floor(args.page) : 1;
+        const limit = args.limit ? Math.min(Math.max(1, Math.floor(args.limit)), 200) : 50;
+        console.error('🔍 Debug listApis:');
+        console.error('  - Access token:', accessToken ? 'Present' : 'Missing');
+        console.error('  - Org ID:', orgId || 'Missing');
+        console.error('  - Filters: search=%s environment=%s page=%d limit=%d', search, environment, page, limit);
+        if (!accessToken) {
+            throw new Error('No access token available');
+        }
+        if (!orgId) {
+            throw new Error('No organization selected. Please select an organization first using manage_organizations tool.');
+        }
+        // Build URL with all supported query params
+        const params = new URLSearchParams();
+        params.set('page', String(page));
+        params.set('limit', String(limit));
+        if (search)
+            params.set('search', search);
+        if (environment)
+            params.set('environment', environment);
+        const url = `${API_ENDPOINTS.API_CATALOG}?${params.toString()}`;
+        console.error('📡 Request: GET', url);
+        const response = await axios.get(url, {
+            headers: {
+                'Authorization': `${tokenType} ${accessToken}`,
+                'Content-Type': 'application/json',
+                'X-Org-ID': orgId
+            },
+            timeout: 30000
+        });
+        console.error('✅ Response status:', response.status);
+        if (response.status !== 200 || !response.data) {
+            throw new Error(`APP request failed with status ${response.status}`);
+        }
+        const responseBody = response.data;
+        const apis = Array.isArray(responseBody) ? responseBody : (responseBody?.data ?? responseBody);
+        const totalCount = responseBody?.total;
+        const hasMore = responseBody?.hasMore ?? (apis.length >= limit);
+        const selectedApiId = authManager.getSelectedApiId();
+        const selectedApiData = authManager.getSelectedApiData();
+        const formattedText = formatAppList(apis, orgId, authManager.getUserInfo(), selectedApiId, selectedApiData, authManager, { search, environment, page, limit, totalCount, hasMore });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formattedText,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (error?.response) {
+            console.error('❌ Response status:', error.response.status);
+            console.error('❌ Response data:', JSON.stringify(error.response.data, null, 2));
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ **Error fetching apps**\n\n🔴 **Error**: ${errorMessage}\n\n💡 **Tip**: Make sure you're authenticated and have an organization selected.\n\n🔄 **Try**: Using manage_organizations tool first to select an organization.`,
+                },
+            ],
+        };
+    }
+}

package/dist/tools/protected/logout.d.ts

@@ -0,0 +1,11 @@
+export declare const logoutTool: {
+    readonly name: "logout";
+    readonly description: "🚪 Logout from PerfAI and clear authentication session";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
+};
+export declare function handleLogout(authManager: any): Promise<any>;
+//# sourceMappingURL=logout.d.ts.map

package/dist/tools/protected/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../../src/tools/protected/logout.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;CAQb,CAAC;AAEX,wBAAsB,YAAY,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAcjE"}

package/dist/tools/protected/logout.js

@@ -0,0 +1,22 @@
+export const logoutTool = {
+    name: "logout",
+    description: "🚪 Logout from PerfAI and clear authentication session",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+export async function handleLogout(authManager) {
+    const userInfo = authManager.getUserInfo();
+    const userEmail = userInfo?.email || 'Unknown user';
+    authManager.clearSession();
+    return {
+        content: [
+            {
+                type: "text",
+                text: `🚪 **Logged Out Successfully**\n\n👋 Goodbye ${userEmail}!\n\n🔐 Your session has been cleared. To access protected tools again, please run the 'login' tool.\n\n📋 **Available tools:** Only 'login' and 'auth_status' are now accessible.`,
+            },
+        ],
+    };
+}

package/dist/tools/protected/manageOrganizations.d.ts

@@ -0,0 +1,26 @@
+export declare const manageOrganizationsTool: {
+    readonly name: "manage_organizations";
+    readonly description: "🏢 List and manage organizations (requires authentication). Use action=select with sequence (number from the list) or org_id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "select", "refresh"];
+                readonly description: "Action to perform: list (show orgs), select (choose org by sequence or org_id), refresh (fetch orgs again)";
+                readonly default: "list";
+            };
+            readonly sequence: {
+                readonly type: "number";
+                readonly description: "Sequence number from the list output (use this instead of org_id)";
+            };
+            readonly org_id: {
+                readonly type: "string";
+                readonly description: "Organization ID to select — use sequence instead when possible";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+export declare function handleManageOrganizations(authManager: any, args: any): Promise<any>;
+//# sourceMappingURL=manageOrganizations.d.ts.map

package/dist/tools/protected/manageOrganizations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manageOrganizations.d.ts","sourceRoot":"","sources":["../../../src/tools/protected/manageOrganizations.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;CAuB1B,CAAC;AAEX,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAoIzF"}

package/dist/tools/protected/manageOrganizations.js

@@ -0,0 +1,147 @@
+import axios from "axios";
+import { API_ENDPOINTS } from "../../config.js";
+import { formatOrganizations } from "../../utils/formatters.js";
+export const manageOrganizationsTool = {
+    name: "manage_organizations",
+    description: "🏢 List and manage organizations (requires authentication). Use action=select with sequence (number from the list) or org_id.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["list", "select", "refresh"],
+                description: "Action to perform: list (show orgs), select (choose org by sequence or org_id), refresh (fetch orgs again)",
+                default: "list"
+            },
+            sequence: {
+                type: "number",
+                description: "Sequence number from the list output (use this instead of org_id)"
+            },
+            org_id: {
+                type: "string",
+                description: "Organization ID to select — use sequence instead when possible"
+            }
+        },
+        additionalProperties: false,
+    },
+};
+export async function handleManageOrganizations(authManager, args) {
+    try {
+        const action = args.action || "list";
+        const orgId = args.org_id;
+        if (action === "refresh") {
+            // Re-fetch organizations
+            try {
+                const accessToken = authManager.getAccessToken();
+                const tokenType = authManager.getTokenType();
+                if (!accessToken) {
+                    throw new Error('No access token available');
+                }
+                const orgResponse = await axios.get(API_ENDPOINTS.ORGANIZATIONS, {
+                    headers: { Authorization: `${tokenType} ${accessToken}` }
+                });
+                const organizations = orgResponse.data.data?.userOrgs || [];
+                const currentOrgId = orgResponse.data.data?.currentOrg;
+                // Update session with fresh org data
+                if (authManager.session) {
+                    authManager.session.organizations = organizations;
+                    authManager.session.selectedOrgId = currentOrgId || organizations[0]?.org_id;
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `🔄 **Organizations Refreshed**\n\n📊 **Found**: ${organizations.length} organizations\n🎯 **Selected**: ${authManager.session?.selectedOrgId}\n\n${organizations.length > 0 ? '✅ Organization data updated successfully!' : '⚠️ No organizations found - you may need to check your account permissions.'}`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ **Failed to refresh organizations**\n\n🔴 **Error**: ${error instanceof Error ? error.message : String(error)}\n\n💡 **Tip**: Check your authentication and network connection.`,
+                        },
+                    ],
+                };
+            }
+        }
+        if (action === "select") {
+            const sequence = args.sequence;
+            if (!sequence && !orgId) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ **Selection Required**\n\n🔴 **Error**: Provide a sequence number or org_id when using action=select\n\n💡 **Examples**:\n• \`manage_organizations {"action": "select", "sequence": 1}\`\n• \`manage_organizations {"action": "select", "org_id": "<id>"}\`\n\nRun \`manage_organizations\` (action=list) first to see sequence numbers.`,
+                        },
+                    ],
+                };
+            }
+            const organizations = authManager.getOrganizations();
+            let selectedOrg;
+            if (sequence) {
+                // Resolve by 1-based sequence number
+                selectedOrg = organizations[sequence - 1];
+                if (!selectedOrg) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `❌ **Invalid Sequence**\n\n🔴 **Error**: Sequence '${sequence}' not found (${organizations.length} org${organizations.length !== 1 ? 's' : ''} available)\n\n💡 **Tip**: Run 'manage_organizations' without arguments to see the list.`,
+                            },
+                        ],
+                    };
+                }
+            }
+            else {
+                selectedOrg = organizations.find((org) => org.org_id === orgId);
+                if (!selectedOrg) {
+                    const availableOrgIds = organizations.map((org) => org.org_id).join(', ');
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `❌ **Organization Not Found**\n\n🔴 **Error**: Organization '${orgId}' not found\n\n📋 **Available**: ${availableOrgIds || 'None'}\n\n💡 **Tip**: Use action=refresh to update organization list`,
+                            },
+                        ],
+                    };
+                }
+            }
+            const resolvedOrgId = selectedOrg.org_id;
+            authManager.setSelectedOrgId(resolvedOrgId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ **Organization Selected**\n\n🏢 **Name**: ${selectedOrg.orgDetails?.name || 'Unknown'}\n🆔 **ID**: ${resolvedOrgId}\n\n🔐 **Status**: Now using this organization for app requests\n🛠️ **Ready**: You can now use list_apps and other org-specific tools!`,
+                    },
+                ],
+            };
+        }
+        // Default action: list
+        const organizations = authManager.getOrganizations();
+        const selectedOrgId = authManager.getSelectedOrgId();
+        const formattedText = formatOrganizations(organizations, selectedOrgId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formattedText,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ **Organization Management Error**\n\n🔴 **Error**: ${errorMessage}\n\n💡 **Tip**: Make sure you're authenticated and try again.`,
+                },
+            ],
+        };
+    }
+}

package/dist/tools/protected/runDesignTest.d.ts

@@ -0,0 +1,21 @@
+export declare const runDesignTestTool: {
+    readonly name: "run_design_test";
+    readonly description: "🚀 Run comprehensive design analysis test using Docker (requires authentication and APP selection)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly spec_url: {
+                readonly type: "string";
+                readonly description: "URL to OpenAPI spec";
+            };
+            readonly local_base_path: {
+                readonly type: "string";
+                readonly description: "Base URL of your basepath";
+            };
+        };
+        readonly required: readonly ["spec_url", "local_base_path"];
+        readonly additionalProperties: true;
+    };
+};
+export declare function handleRunDesignTest(authManager: any, args: any): Promise<any>;
+//# sourceMappingURL=runDesignTest.d.ts.map

package/dist/tools/protected/runDesignTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDesignTest.d.ts","sourceRoot":"","sources":["../../../src/tools/protected/runDesignTest.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAEX,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CA2HnF"}

package/dist/tools/protected/runDesignTest.js

@@ -0,0 +1,132 @@
+import { runDockerDesignTest } from "../../utils/dockerRunner.js";
+import axios from "axios";
+import { API_ENDPOINTS } from "../../config.js";
+export const runDesignTestTool = {
+    name: "run_design_test",
+    description: "🚀 Run comprehensive design analysis test using Docker (requires authentication and APP selection)",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spec_url: {
+                type: "string",
+                description: "URL to OpenAPI spec"
+            },
+            local_base_path: {
+                type: "string",
+                description: "Base URL of your basepath"
+            }
+        },
+        required: ["spec_url", "local_base_path"],
+        additionalProperties: true,
+    },
+};
+export async function handleRunDesignTest(authManager, args) {
+    try {
+        const specUrl = args.spec_url;
+        const localBasePath = args.local_base_path;
+        const accessToken = authManager.getAccessToken();
+        const tokenType = authManager.getTokenType();
+        const orgId = authManager.getSelectedOrgId();
+        const selectedAppId = authManager.getSelectedApiId();
+        if (!accessToken) {
+            throw new Error('No access token available');
+        }
+        if (!orgId) {
+            throw new Error('No organization selected. Please select an organization first using manage_organizations tool.');
+        }
+        if (!selectedAppId) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ **No APP Selected**\n\n🎯 **Required**: You must select an APP first to run design tests.\n\n📋 **Steps**:\n1. Run \`list_apps\` to see available APPs\n2. Run \`select_app\` with an APP ID\n3. Run \`show_design_issues\` to get the design app ID\n4. Then run this tool again`,
+                    },
+                ],
+            };
+        }
+        // First, get the app details using the catalog ID to get the design app ID
+        const catalogUrl = `${API_ENDPOINTS.API_CATALOG_SERVICE_IDS}/${selectedAppId}`;
+        let appDetails;
+        try {
+            const catalogResponse = await axios.get(catalogUrl, {
+                headers: {
+                    'Authorization': `${tokenType} ${accessToken}`,
+                    'Content-Type': 'application/json',
+                    'X-Org-ID': orgId
+                },
+                timeout: 30000
+            });
+            if (catalogResponse.status !== 200 || !catalogResponse.data) {
+                throw new Error(`Failed to fetch app details with status ${catalogResponse.status}`);
+            }
+            appDetails = catalogResponse.data;
+            if (!appDetails.design_test_appId) {
+                throw new Error('No design_test_appId found for this app');
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ **Error fetching app details**\n\n🔴 **Error**: ${errorMessage}\n\n💡 **Tip**: Make sure the selected app has design testing enabled.`,
+                    },
+                ],
+            };
+        }
+        // Use the design_test_appId for running design tests
+        const designAppId = appDetails.design_test_appId;
+        if (!specUrl) {
+            throw new Error('Spec URL is required');
+        }
+        if (!localBasePath) {
+            throw new Error('Local base path is required');
+        }
+        // Validate URLs
+        try {
+            new URL(specUrl);
+            new URL(localBasePath);
+        }
+        catch (error) {
+            throw new Error('Invalid URL format. Please provide valid URLs for spec_url and local_base_path');
+        }
+        // Run Docker design test using the selected app ID
+        console.error('🚀 Running Docker design test...');
+        const result = await runDockerDesignTest({
+            apiId: designAppId,
+            orgId,
+            accessToken,
+            specUrl,
+            localBasePath
+        });
+        // Wait 40 seconds for the system to process and update design issues
+        console.error('⏳ Waiting 40 seconds for system to process design issues...');
+        await new Promise(resolve => setTimeout(resolve, 40000));
+        console.error('✅ Wait completed, design issues should be processed');
+        // Create response based on Docker test result
+        const dockerStatus = result.success ? '✅ **Docker Test**: Completed Successfully' : '❌ **Docker Test**: Failed';
+        const dockerOutput = result.success
+            ? `📋 **Test Output**:\n\`\`\`\n${result.output || 'Test completed - check your PerfAI dashboard for results'}\n\`\`\``
+            : `📋 **Error Output**:\n\`\`\`\n${result.errors || 'Unknown error occurred'}\n\`\`\``;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `🚀 **Design Test Results**\n\n${dockerStatus}\n\n🎯 **APP**: ${selectedAppId}\n🎨 **Spec URL**: ${specUrl}\n🌐 **Base Path**: ${localBasePath}\n🏢 **Organization**: ${orgId}\n\n${dockerOutput}\n\n⏳ **Processing Wait**: System waited 40 seconds after Docker test completion to ensure design issues were fully processed and updated.\n\n✅ **Status**: Design analysis completed. Results should be available in your PerfAI dashboard.\n\n💡 **Next Steps**:\n1. Check your PerfAI dashboard for detailed results\n2. Use \`show_design_issues\` to see any new issues found\n3. Use \`ai_fix_design_issue\` to generate fixes for remaining issues\n4. Use \`check_design_fixes\` to verify which previously fixed issues were actually resolved`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ **Error running design test**\n\n🔴 **Error**: ${errorMessage}\n\n💡 **Tip**: Make sure you're authenticated, have an organization selected, and provided valid URLs.\n\n🔄 **Try**: Check your inputs and try again.`,
+                },
+            ],
+        };
+    }
+}

package/dist/tools/protected/runQualityTest.d.ts

@@ -0,0 +1,21 @@
+export declare const runQualityTestTool: {
+    readonly name: "run_quality_test";
+    readonly description: "🚀 Run comprehensive quality/specification validation analysis test using Docker (requires authentication and APP selection)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly spec_url: {
+                readonly type: "string";
+                readonly description: "URL to OpenAPI spec";
+            };
+            readonly local_base_path: {
+                readonly type: "string";
+                readonly description: "Base URL of your basepath";
+            };
+        };
+        readonly required: readonly ["spec_url", "local_base_path"];
+        readonly additionalProperties: true;
+    };
+};
+export declare function handleRunQualityTest(authManager: any, args: any): Promise<any>;
+//# sourceMappingURL=runQualityTest.d.ts.map

package/dist/tools/protected/runQualityTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runQualityTest.d.ts","sourceRoot":"","sources":["../../../src/tools/protected/runQualityTest.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;CAkBrB,CAAC;AAEX,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CA+IpF"}