@camunda/e2e-test-suite 0.0.484 → 0.0.485

package/dist/pages/8.10/ClusterDetailsPage.d.ts

@@ -1,4 +1,5 @@
 import { Page, Locator } from '@playwright/test';
+import { McpCredentials } from '../../utils/mcpSecrets';
 import { ClientCredentialsDetailsPage } from './ClientCredentialsDetailsPage';
 declare class ClusterDetailsPage {
     private page;
@@ -41,6 +42,9 @@ declare class ClusterDetailsPage {
     readonly reviewUpdateButton: Locator;
     readonly updateAvailableDialog: Locator;
     readonly updateButton: Locator;
+    readonly mcpSupportToggle: Locator;
+    readonly mcpTab: Locator;
+    readonly mcpTextarea: Locator;
     constructor(page: Page);
     clickAPITab(): Promise<void>;
     clickCreateClientButton(): Promise<void>;
@@ -67,7 +71,7 @@ declare class ClusterDetailsPage {
     deleteAlerts(): Promise<void>;
     private doDelete;
     assertComponentsHealth(components?: string[]): Promise<void>;
-    createAPIClientAndReturnVariables(name: string, setEnvVariables?: boolean): Promise<{
+    createAPIClientAndReturnVariables(name: string, setEnvVariables?: boolean, clusterType?: string): Promise<{
         [key: string]: string;
     }>;
     createAPIClient(name: string): Promise<void>;
@@ -82,5 +86,9 @@ declare class ClusterDetailsPage {
     checkOrchestrationClusterCheckbox(): Promise<void>;
     clickReviewUpdateButton(): Promise<void>;
     performClusterUpdate(): Promise<void>;
+    checkMcpSupportToggle(): Promise<void>;
+    clickMCPTab(): Promise<void>;
+    getMcpConfigurationText(): Promise<string>;
+    createMCPClientAndReturnVariables(name: string, setEnvVariables?: boolean): Promise<McpCredentials>;
 }
 export { ClusterDetailsPage };

package/dist/pages/8.10/ClusterDetailsPage.js

@@ -47,6 +47,9 @@ class ClusterDetailsPage {
     reviewUpdateButton;
     updateAvailableDialog;
     updateButton;
+    mcpSupportToggle;
+    mcpTab;
+    mcpTextarea;
     constructor(page) {
         this.page = page;
         this.apiTab = page.getByRole('tab', { name: 'API' });
@@ -145,6 +148,11 @@ class ClusterDetailsPage {
         this.updateButton = this.updateAvailableDialog.getByRole('button', {
             name: 'Update',
         });
+        this.mcpSupportToggle = page.getByRole('switch', {
+            name: /Enable MCP Support/i,
+        });
+        this.mcpTab = page.getByRole('tab', { name: 'MCP' });
+        this.mcpTextarea = page.getByRole('textbox', { name: 'Copy to clipboard' });
     }
     async clickAPITab() {
         await (0, test_1.expect)(this.apiTab).toBeVisible({ timeout: 60000 });
@@ -372,7 +380,7 @@ class ClusterDetailsPage {
             });
         }
     }
-    async createAPIClientAndReturnVariables(name, setEnvVariables = true) {
+    async createAPIClientAndReturnVariables(name, setEnvVariables = true, clusterType) {
         await this.createAPIClient(name);
         await this.clickEnvVarsButton();
         const variables = {
@@ -384,13 +392,29 @@ class ClusterDetailsPage {
             optimizeBaseUrl: await this.clientCredentialsText(/export CAMUNDA_OPTIMIZE_BASE_URL='([^']+)'/),
         };
         if (setEnvVariables) {
-            process.env.ZEEBE_API_CLIENT_ID = variables.zeebeClientId;
-            process.env.ZEEBE_API_CLIENT_SECRET = variables.zeebeClientSecret;
-            process.env.ZEEBE_API_AUTH_URL = variables.zeebeAuthUrl;
-            process.env.ZEEBE_API_URL = variables.zeebeUrl;
-            process.env.ZEEBE_API_TOKEN_AUDIENCE = variables.tokenAudience;
-            process.env.CAMUNDA_OPTIMIZE_BASE_URL = variables.optimizeBaseUrl;
-            process.env.OPTIMIZE_API_TOKEN_AUDIENCE = 'optimize.ultrawombat.com';
+            if (clusterType) {
+                // Use cluster-specific suffixed env vars
+                const suffix = clusterType.toUpperCase().replace(/[\s-]/g, '_');
+                process.env[`ZEEBE_API_CLIENT_ID_${suffix}`] = variables.zeebeClientId;
+                process.env[`ZEEBE_API_CLIENT_SECRET_${suffix}`] =
+                    variables.zeebeClientSecret;
+                process.env[`ZEEBE_API_AUTH_URL_${suffix}`] = variables.zeebeAuthUrl;
+                process.env[`ZEEBE_API_URL_${suffix}`] = variables.zeebeUrl;
+                process.env[`ZEEBE_API_TOKEN_AUDIENCE_${suffix}`] =
+                    variables.tokenAudience;
+                process.env[`CAMUNDA_OPTIMIZE_BASE_URL_${suffix}`] =
+                    variables.optimizeBaseUrl;
+                console.log(`[ClusterDetailsPage] Set credentials for cluster type: ${clusterType}`);
+            }
+            else {
+                process.env.ZEEBE_API_CLIENT_ID = variables.zeebeClientId;
+                process.env.ZEEBE_API_CLIENT_SECRET = variables.zeebeClientSecret;
+                process.env.ZEEBE_API_AUTH_URL = variables.zeebeAuthUrl;
+                process.env.ZEEBE_API_URL = variables.zeebeUrl;
+                process.env.ZEEBE_API_TOKEN_AUDIENCE = variables.tokenAudience;
+                process.env.CAMUNDA_OPTIMIZE_BASE_URL = variables.optimizeBaseUrl;
+                process.env.OPTIMIZE_API_TOKEN_AUDIENCE = 'optimize.ultrawombat.com';
+            }
         }
         return variables;
     }
@@ -500,5 +524,45 @@ class ClusterDetailsPage {
         await (0, test_1.expect)(this.updateAvailableDialog).toBeVisible({ timeout: 30000 });
         await this.updateButton.click({ timeout: 60000 });
     }
+    async checkMcpSupportToggle() {
+        if (!(await this.mcpSupportToggle.isVisible())) {
+            throw new Error('MCP Support toggle is not visible');
+        }
+        // Only click if not already enabled to avoid disabling on reruns
+        if (!(await this.mcpSupportToggle.isChecked())) {
+            await this.mcpSupportToggle.click({ force: true });
+        }
+        await (0, test_1.expect)(this.mcpSupportToggle).toBeChecked();
+    }
+    async clickMCPTab() {
+        await (0, test_1.expect)(this.mcpTab).toBeVisible({ timeout: 60000 });
+        await this.mcpTab.click();
+    }
+    async getMcpConfigurationText() {
+        await (0, test_1.expect)(this.mcpTextarea).toBeVisible({ timeout: 60000 });
+        return await this.mcpTextarea.innerText();
+    }
+    async createMCPClientAndReturnVariables(name, setEnvVariables = true) {
+        await this.createAPIClient(name);
+        await this.clickMCPTab();
+        const mcpConfigText = await this.getMcpConfigurationText();
+        const mcpConfig = JSON.parse(mcpConfigText);
+        const env = Object.values(mcpConfig.servers)[0].env;
+        const credentials = {
+            baseURL: env.CAMUNDA_BASE_URL,
+            clientID: env.CAMUNDA_CLIENT_ID,
+            clientSecret: env.CAMUNDA_CLIENT_SECRET,
+            OauthURL: env.CAMUNDA_OAUTH_URL,
+            tokenAudience: env.CAMUNDA_TOKEN_AUDIENCE,
+        };
+        if (setEnvVariables) {
+            process.env.MCP_BASE_URL = credentials.baseURL;
+            process.env.MCP_CLIENT_ID = credentials.clientID;
+            process.env.MCP_CLIENT_SECRET = credentials.clientSecret;
+            process.env.MCP_OAUTH_URL = credentials.OauthURL;
+            process.env.MCP_TOKEN_AUDIENCE = credentials.tokenAudience;
+        }
+        return credentials;
+    }
 }
 exports.ClusterDetailsPage = ClusterDetailsPage;

package/dist/tests/8.10/orchestration-cluster-mcp-server/mcp-cluster-tools.spec.d.ts

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

package/dist/tests/8.10/orchestration-cluster-mcp-server/mcp-cluster-tools.spec.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const _8_10_1 = require("../../../fixtures/8.10");
+const UtilitiesPage_1 = require("../../../pages/8.10/UtilitiesPage");
+const _setup_1 = require("../../../test-setup.js");
+const apiHelpers_1 = require("../../../utils/apiHelpers");
+const users_1 = require("../../../utils/users");
+const test_1 = require("@playwright/test");
+const testUser = (0, users_1.getTestUser)('fourteenthUser');
+let authToken;
+let instanceKey;
+_8_10_1.test.describe.configure({ mode: 'parallel' });
+_8_10_1.test.describe('Orchestration Cluster MCP Server - Cluster Tools @tasklistV2', () => {
+    const clusterName = 'Agentic Orchestration Cluster';
+    _8_10_1.test.beforeAll(async () => {
+        authToken = await (0, apiHelpers_1.authSaasAPI)(undefined, 'agentic_cluster');
+        const processDefinitionKey = await (0, apiHelpers_1.deployProcess)('./resources/mcp_server_saas/mcp_cluster_tools.bpmn', authToken, 'saas', 'agentic_cluster');
+        if (processDefinitionKey == null) {
+            throw new Error('Failed to deploy cluster tools process');
+        }
+        instanceKey = await (0, apiHelpers_1.createProcessInstance)(String(processDefinitionKey), authToken, 'saas', 'agentic_cluster');
+    });
+    _8_10_1.test.beforeEach(async ({ page, loginPage }, testInfo) => {
+        await (0, UtilitiesPage_1.loginWithRetry)(page, loginPage, testUser, (testInfo.workerIndex + 1) * 1000);
+    });
+    _8_10_1.test.afterEach(async ({ page }, testInfo) => {
+        await (0, _setup_1.captureScreenshot)(page, testInfo);
+        await (0, _setup_1.captureFailureVideo)(page, testInfo);
+    });
+    const clusterToolTests = [
+        {
+            name: 'getClusterStatus - returns cluster health status',
+            variable: 'mcpResultClusterStatus',
+            assertions: [
+                {
+                    text: 'HEALTHY',
+                    description: 'cluster status response contains healthy field',
+                },
+            ],
+        },
+        {
+            name: 'getTopology - returns cluster topology information',
+            variable: 'mcpResultTopology',
+            assertions: [
+                { text: 'brokers', description: 'topology response contains brokers' },
+                {
+                    text: 'partitionsCount',
+                    description: 'topology response contains partitions count',
+                },
+            ],
+        },
+    ];
+    for (const testCase of clusterToolTests) {
+        (0, _8_10_1.test)(testCase.name, async ({ homePage, appsPage, operateHomePage, operateProcessesPage, operateProcessInstancePage, }) => {
+            _8_10_1.test.slow();
+            await _8_10_1.test.step('Navigate to completed process in Operate', async () => {
+                await homePage.clickClusters();
+                await appsPage.clickOperate(clusterName);
+                await (0, test_1.expect)(operateHomePage.operateBanner).toBeVisible({
+                    timeout: 60000,
+                });
+                await operateHomePage.clickProcessesTab();
+                await operateProcessesPage.clickProcessCompletedCheckbox();
+                await operateProcessesPage.applyMoreFilters('Process Instance Key(s)', String(instanceKey));
+                await operateProcessesPage.clickProcessInstanceLink('MCP Cluster tools');
+                await operateProcessInstancePage.assertProcessCompleteStatusWithRetry();
+            });
+            for (const assertion of testCase.assertions) {
+                await _8_10_1.test.step(`Verify ${assertion.description}`, async () => {
+                    await operateProcessInstancePage.assertProcessVariableContainsText(testCase.variable, assertion.text);
+                });
+            }
+        });
+    }
+});

package/dist/tests/8.10/orchestration-cluster-mcp-server/mcp-incident-tools.spec.d.ts

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

package/dist/tests/8.10/orchestration-cluster-mcp-server/mcp-incident-tools.spec.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const _8_10_1 = require("../../../fixtures/8.10");
+const UtilitiesPage_1 = require("../../../pages/8.10/UtilitiesPage");
+const _setup_1 = require("../../../test-setup.js");
+const apiHelpers_1 = require("../../../utils/apiHelpers");
+const incidentHelpers_1 = require("../../../utils/incidentHelpers");
+const users_1 = require("../../../utils/users");
+const test_1 = require("@playwright/test");
+const testUser = (0, users_1.getTestUser)('fifteenthUser');
+let authToken;
+let toolsInstanceKey;
+_8_10_1.test.describe.configure({ mode: 'parallel' });
+_8_10_1.test.describe('Orchestration Cluster MCP Server - Incident Tools @tasklistV2', () => {
+    const clusterName = 'Agentic Orchestration Cluster';
+    _8_10_1.test.beforeAll(async () => {
+        authToken = await (0, apiHelpers_1.authSaasAPI)(undefined, 'agentic_cluster');
+        const [testFileProcessKey, toolsProcessKey] = await Promise.all([
+            (0, apiHelpers_1.deployProcess)('./resources/mcp_server_saas/mcp_incident_test_file.bpmn', authToken, 'saas', 'agentic_cluster'),
+            (0, apiHelpers_1.deployProcess)('./resources/mcp_server_saas/mcp_incident_tools.bpmn', authToken, 'saas', 'agentic_cluster'),
+        ]);
+        if (testFileProcessKey == null || toolsProcessKey == null) {
+            throw new Error('Failed to deploy incident tools processes');
+        }
+        // Create test instance — the call activity in the BPMN references a
+        // non-existent process, so Zeebe raises a CALLED_ELEMENT_ERROR incident
+        // immediately without needing a worker.
+        const testInstanceKey = await (0, apiHelpers_1.createProcessInstance)(String(testFileProcessKey), authToken, 'saas', 'agentic_cluster');
+        // Get the incident key created by the test instance (with retry logic)
+        const testIncidentKey = await (0, incidentHelpers_1.getIncidentKeyByProcessInstanceKey)(testInstanceKey, authToken, 'saas', 'agentic_cluster');
+        console.log('Creating tools instance with variables:', {
+            testFileProcessKey,
+            testIncidentKey,
+        });
+        // Create tools instance with required variables
+        toolsInstanceKey = await (0, apiHelpers_1.createProcessInstance)(String(toolsProcessKey), authToken, 'saas', 'agentic_cluster', { testFileProcessKey, testIncidentKey });
+    });
+    _8_10_1.test.beforeEach(async ({ page, loginPage }, testInfo) => {
+        await (0, UtilitiesPage_1.loginWithRetry)(page, loginPage, testUser, (testInfo.workerIndex + 1) * 1000);
+    });
+    _8_10_1.test.afterEach(async ({ page }, testInfo) => {
+        await (0, _setup_1.captureScreenshot)(page, testInfo);
+        await (0, _setup_1.captureFailureVideo)(page, testInfo);
+    });
+    const incidentToolTests = [
+        {
+            name: 'searchIncidents - search incidents with filters such as processDefinitionKey',
+            variable: 'mcpResultSearchIncidents',
+            assertions: [
+                {
+                    text: 'totalItems',
+                    description: 'search response contains totalItems field',
+                },
+                {
+                    text: 'incidentKey',
+                    description: 'search response contains incidentKey field',
+                },
+                {
+                    text: 'processDefinitionKey',
+                    description: 'search response contains processDefinitionKey field',
+                },
+                {
+                    text: 'state',
+                    description: 'search response contains state field',
+                },
+            ],
+        },
+        {
+            name: 'getIncident - retrieve an incident by key',
+            variable: 'mcpResultGetIncident',
+            assertions: [
+                {
+                    text: 'incidentKey',
+                    description: 'response contains incidentKey field',
+                },
+                {
+                    text: 'processInstanceKey',
+                    description: 'response contains processInstanceKey field',
+                },
+                {
+                    text: 'errorType',
+                    description: 'response contains errorType field',
+                },
+                {
+                    text: 'state',
+                    description: 'response contains state field',
+                },
+            ],
+        },
+        {
+            name: 'resolveIncident - resolve an incident by key',
+            variable: 'mcpResultResolveIncident',
+            assertions: [
+                {
+                    text: 'resolved',
+                    description: 'response confirms incident was resolved',
+                },
+            ],
+        },
+    ];
+    for (const testCase of incidentToolTests) {
+        (0, _8_10_1.test)(testCase.name, async ({ homePage, appsPage, operateHomePage, operateProcessesPage, operateProcessInstancePage, }) => {
+            _8_10_1.test.slow();
+            await _8_10_1.test.step('Navigate to completed process in Operate', async () => {
+                await homePage.clickClusters();
+                await appsPage.clickOperate(clusterName);
+                await (0, test_1.expect)(operateHomePage.operateBanner).toBeVisible({
+                    timeout: 60000,
+                });
+                await operateHomePage.clickProcessesTab();
+                await operateProcessesPage.clickProcessCompletedCheckbox();
+                await operateProcessesPage.applyMoreFilters('Process Instance Key(s)', String(toolsInstanceKey));
+                await operateProcessesPage.clickProcessInstanceLink('MCP Incident Tools');
+                await operateProcessInstancePage.assertProcessCompleteStatusWithRetry();
+            });
+            for (const assertion of testCase.assertions) {
+                await _8_10_1.test.step(assertion.description, async () => {
+                    await operateProcessInstancePage.assertProcessVariableContainsText(testCase.variable, assertion.text);
+                });
+            }
+        });
+    }
+});

package/dist/tests/8.10/test-setup.spec.js

@@ -4,6 +4,7 @@ const test_1 = require("@playwright/test");
 const _8_10_1 = require("../../fixtures/8.10");
 const _setup_1 = require("../../test-setup.js");
 const connectorSecrets_1 = require("../../utils/connectorSecrets");
+const mcpSecrets_1 = require("../../utils/mcpSecrets");
 const UtilitiesPage_1 = require("../../pages/8.10/UtilitiesPage");
 const users_1 = require("../../utils/users");
 _8_10_1.test.describe.configure({ mode: 'parallel' });
@@ -44,6 +45,32 @@ _8_10_1.test.describe('Cluster Setup Tests', () => {
             await clusterSecretsPage.createSetOfSecrets(clusterName, connectorSecrets_1.agentcoreSecretsValues);
         }
     });
+    (0, _8_10_1.test)('Create Agentic Orchestration Cluster', async ({ page, loginPage, homePage, clusterPage, clusterDetailsPage, clusterSecretsPage, }, testInfo) => {
+        _8_10_1.test.skip(process.env.IS_PROD === 'true', 'Skipping test because not required on PROD test org');
+        _8_10_1.test.skip(process.env.IS_AG === 'true', 'Skipping test because not required when IS_AG is true');
+        _8_10_1.test.slow();
+        const clusterName = 'Agentic Orchestration Cluster';
+        const apiClientName = 'Test_API_Client' + (await (0, _setup_1.generateRandomStringAsync)(3));
+        const mcpClientName = 'MCP_Test_API_Client' + (await (0, _setup_1.generateRandomStringAsync)(3));
+        await (0, UtilitiesPage_1.loginWithRetry)(page, loginPage, users_1.testUsers.mainUser, (testInfo.workerIndex + 1) * 1000);
+        await homePage.clickClusters();
+        await clusterPage.createCluster(clusterName);
+        await clusterPage.assertClusterHealthyStatusWithRetry(clusterName);
+        await clusterPage.clickClusterLink(clusterName);
+        await clusterDetailsPage.assertComponentsHealth();
+        await clusterDetailsPage.clickSettingsTab();
+        await clusterDetailsPage.checkMcpSupportToggle();
+        await homePage.clickClusters();
+        await clusterPage.assertClusterHealthyStatusWithRetry(clusterName);
+        await clusterPage.clickClusterLink(clusterName);
+        await clusterDetailsPage.clickAPITab();
+        await clusterDetailsPage.createAPIClientAndReturnVariables(apiClientName, true, 'agentic_cluster');
+        await clusterDetailsPage.clickCloseModalButton();
+        const mcpCredentials = await clusterDetailsPage.createMCPClientAndReturnVariables(mcpClientName);
+        await clusterDetailsPage.clickCloseModalButton();
+        await clusterPage.clickConnectorSecretsTab(clusterName);
+        await clusterSecretsPage.createSetOfSecrets(clusterName, (0, mcpSecrets_1.mcpSecretsValues)(mcpCredentials));
+    });
     (0, _8_10_1.test)('Create AWS Cluster', async ({ page, loginPage, homePage, clusterPage, clusterDetailsPage, clusterSecretsPage, }, testInfo) => {
         _8_10_1.test.slow();
         const clusterName = 'AWS Cluster';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camunda/e2e-test-suite",
-  "version": "0.0.484",
+  "version": "0.0.485",
   "description": "End-to-end test helpers for Camunda 8",
   "repository": {
     "type": "git",