@camunda/e2e-test-suite 0.0.243 → 0.0.244

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

@@ -1,5 +1,6 @@
 import { Page, Locator } from '@playwright/test';
 import { ClientCredentialsDetailsPage } from './ClientCredentialsDetailsPage';
+import { McpCredentials } from '../../utils/mcpSecrets';
 declare class ClusterDetailsPage {
     private page;
     readonly apiTab: Locator;
@@ -40,6 +41,9 @@ declare class ClusterDetailsPage {
     readonly clientCredentialsLink: (clientCredentials: string) => Locator;
     readonly clientRow: (name: string) => Locator;
     readonly clientRowDeleteButton: (name: string) => Locator;
+    readonly mcpSupportToggle: Locator;
+    readonly mcpTab: Locator;
+    readonly mcpTextarea: Locator;
     constructor(page: Page);
     clickAPITab(): Promise<void>;
     clickCreateClientButton(): Promise<void>;
@@ -66,7 +70,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>;
@@ -79,5 +83,10 @@ declare class ClusterDetailsPage {
     fillAPIClientName(name: string): Promise<void>;
     assertAlertText(text: string, timeout?: number, maxRetries?: number): Promise<void>;
     checkOrchestrationClusterCheckbox(): Promise<void>;
+    checkMcpSupportToggle(): Promise<void>;
+    clickMCPTab(): Promise<void>;
+    clickMCPTextarea(): Promise<void>;
+    getMcpConfigurationText(): Promise<string>;
+    createMCPClientAndReturnVariables(name: string, setEnvVariables?: boolean): Promise<McpCredentials>;
 }
 export { ClusterDetailsPage };

package/dist/pages/8.9/ClusterDetailsPage.js

@@ -46,6 +46,9 @@ class ClusterDetailsPage {
     clientCredentialsLink;
     clientRow;
     clientRowDeleteButton;
+    mcpSupportToggle;
+    mcpTab;
+    mcpTextarea;
     constructor(page) {
         this.page = page;
         this.apiTab = page.getByRole('tab', { name: 'API' });
@@ -128,6 +131,11 @@ class ClusterDetailsPage {
         this.clientCredentialsLink = (clientCredentials) => page.getByRole('cell', { name: clientCredentials });
         this.clientRow = (name) => this.clientsList.filter({ hasText: name });
         this.clientRowDeleteButton = (name) => this.clientRow(name).getByRole('button', { name: 'Delete' });
+        this.mcpSupportToggle = page.getByRole('switch', {
+            name: /Enable MCP Support/i,
+        });
+        this.mcpTab = page.getByRole('tab', { name: 'MCP' });
+        this.mcpTextarea = page.getByLabel('MCP', { exact: true }).locator('pre');
     }
     async clickAPITab() {
         await (0, test_1.expect)(this.apiTab).toBeVisible({ timeout: 60000 });
@@ -355,7 +363,7 @@ class ClusterDetailsPage {
             });
         }
     }
-    async createAPIClientAndReturnVariables(name, setEnvVariables = true) {
+    async createAPIClientAndReturnVariables(name, setEnvVariables = true, clusterType) {
         await this.createAPIClient(name);
         await this.clickEnvVarsButton();
         const variables = {
@@ -367,13 +375,31 @@ 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 {
+                // Default/Test cluster - use standard env vars (existing behavior)
+                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';
+                console.log('[ClusterDetailsPage] Set credentials for default Test Cluster');
+            }
         }
         return variables;
     }
@@ -475,5 +501,49 @@ class ClusterDetailsPage {
             await this.orchestrationClusterCheckbox.click();
         }
     }
+    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 clickMCPTextarea() {
+        await (0, test_1.expect)(this.mcpTextarea).toBeVisible({ timeout: 60000 });
+        await this.mcpTextarea.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 = mcpConfig.servers.camunda.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/pages/SM-8.6/ModelerCreatePage.js

@@ -521,6 +521,7 @@ class ModelerCreatePage {
                 await this.tasklistAudienceTextbox.fill('tasklist-api');
                 await this.continueToPlayButton.click({ timeout });
                 await (0, test_1.expect)(this.page.getByText('Play environment is ready')).toBeVisible({ timeout: 90000 });
+                await (0, test_1.expect)(this.dialog).not.toBeVisible();
                 return; // Exit if successful
             }
             catch (error) {

package/dist/pages/SM-8.6/OperateProcessesPage.js

@@ -44,6 +44,7 @@ class OperateProcessesPage {
         this.tenantDropdownOption = (name) => page.getByRole('option', { name: name });
     }
     async checkCheckbox(checkbox) {
+        await checkbox.waitFor({ state: 'visible', timeout: constants_1._1_SECOND_IN_MS * 10 });
         if (!(await checkbox.isChecked())) {
             await checkbox.click();
             await (0, test_1.expect)(checkbox).toBeChecked({
@@ -157,7 +158,7 @@ class OperateProcessesPage {
                     throw new Error(`Failed to open instance "${processName}" after ${MAX_ATTEMPTS} attempts. Last error: ${String(err)}`);
                 }
                 await this.page.reload();
-                await (0, sleep_1.sleep)(1000);
+                await (0, sleep_1.sleep)(5000);
             }
         }
     }

package/dist/pages/SM-8.6/PlayPage.d.ts

@@ -2,6 +2,11 @@ import { Page, Locator } from '@playwright/test';
 declare class PlayPage {
     private page;
     readonly completeJobButton: Locator;
+    readonly restartProcess: Locator;
+    readonly diagram: Locator;
+    readonly startInstanceButton: Locator;
+    readonly loadingInstanceDetailsText: Locator;
+    readonly dialog: Locator;
     constructor(page: Page);
     waitForCompleteJobButtonToBeAvailable(): Promise<void>;
     clickCompleteJobButton(): Promise<void>;

package/dist/pages/SM-8.6/PlayPage.js

@@ -2,15 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlayPage = void 0;
 const test_1 = require("@playwright/test");
+const sleep_1 = require("../../utils/sleep");
 const maxWaitTimeSeconds = 120000;
 class PlayPage {
     page;
     completeJobButton;
+    restartProcess;
+    diagram;
+    startInstanceButton;
+    loadingInstanceDetailsText;
+    dialog;
     constructor(page) {
         this.page = page;
         this.completeJobButton = page
             .getByTestId('diagram')
             .getByLabel('Complete job');
+        this.restartProcess = this.page.getByRole('button', {
+            name: 'Restart process',
+        });
+        this.diagram = page.getByTestId('diagram');
+        this.startInstanceButton = this.page
+            .getByTestId('diagram')
+            .getByLabel('Start instance');
+        this.loadingInstanceDetailsText = this.page.getByText('Loading instance details...');
+        this.dialog = page.getByRole('dialog');
     }
     async waitForCompleteJobButtonToBeAvailable() {
         await (0, test_1.expect)(this.completeJobButton).toBeVisible({
@@ -21,7 +36,27 @@ class PlayPage {
         await this.completeJobButton.click();
     }
     async clickStartInstanceButton() {
-        await this.page.getByTestId('diagram').getByLabel('Start instance').click();
+        const maxRetries = 3;
+        let attempts = 0;
+        while (attempts < maxRetries) {
+            try {
+                await this.diagram.waitFor({ state: 'visible', timeout: 30000 });
+                await this.startInstanceButton.click({ timeout: 30000 });
+                await (0, test_1.expect)(this.loadingInstanceDetailsText).toBeVisible();
+                await (0, test_1.expect)(this.loadingInstanceDetailsText).not.toBeVisible({
+                    timeout: 60000,
+                });
+                await (0, test_1.expect)(this.dialog).not.toBeVisible({ timeout: 15000 });
+                return;
+            }
+            catch (error) {
+                if (attempts >= maxRetries - 1)
+                    throw error;
+                await this.page.reload();
+                await (0, sleep_1.sleep)(2000);
+                attempts++;
+            }
+        }
     }
     async dismissStartModal() {
         await this.page
@@ -31,7 +66,7 @@ class PlayPage {
             .click();
     }
     async waitForInstanceDetailsToBeLoaded() {
-        const maxRetries = 2;
+        const maxRetries = 3;
         let attempts = 0;
         while (attempts < maxRetries) {
             try {
@@ -47,6 +82,9 @@ class PlayPage {
                 if (attempts >= maxRetries - 1)
                     throw error;
                 await this.page.reload();
+                const startButton = this.restartProcess.or(this.startInstanceButton);
+                await startButton.waitFor({ state: 'visible', timeout: 30000 });
+                await startButton.click();
                 attempts++;
             }
         }

package/dist/pages/SM-8.6/TaskDetailsPage.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskDetailsPage = void 0;
 const test_1 = require("@playwright/test");
+const sleep_1 = require("../../utils/sleep");
+const expectLocatorWithRetry_1 = require("../../utils/assertionHelpers/expectLocatorWithRetry");
 function cardinalToOrdinal(numberValue) {
     const realOrderIndex = numberValue.toString();
     if (['11', '12', '13'].includes(realOrderIndex.slice(-2))) {
@@ -96,15 +98,36 @@ class TaskDetailsPage {
             .getByText('Assigned to me');
     }
     async clickAssignToMeButton() {
-        await this.assignToMeButton.click();
+        await (0, test_1.expect)(this.assignToMeButton).toBeVisible({ timeout: 60000 });
+        await this.assignToMeButton.click({ timeout: 60000 });
+        await (0, sleep_1.sleep)(1000);
+        await (0, expectLocatorWithRetry_1.expectLocatorWithRetry)(this.page, this.assignedToMeText, {
+            postAction: async () => {
+                await this.page.reload();
+                await (0, sleep_1.sleep)(5000);
+                if (await this.assignToMeButton.isVisible()) {
+                    await this.assignToMeButton.click({ timeout: 60000 });
+                }
+            },
+        });
     }
     async clickUnassignButton() {
         await this.unassignButton.click();
     }
     async clickCompleteTaskButton() {
         await this.completeTaskButton.click({ timeout: 60000 });
-        await (0, test_1.expect)(this.taskCompletedBanner).toBeVisible({
-            timeout: 200000,
+        await (0, test_1.expect)(this.page.getByText('Completing task...')).not.toBeVisible({
+            timeout: 60000,
+        });
+        await (0, sleep_1.sleep)(1000);
+        await (0, expectLocatorWithRetry_1.expectLocatorWithRetry)(this.page, this.taskCompletedBanner, {
+            postAction: async () => {
+                await this.page.reload();
+                await (0, sleep_1.sleep)(5000);
+                if (await this.completeTaskButton.isVisible()) {
+                    await this.completeTaskButton.click({ timeout: 60000 });
+                }
+            },
         });
     }
     async clickAddVariableButton() {

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

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

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

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const _8_9_1 = require("../../../fixtures/8.9");
+const UtilitiesPage_1 = require("../../../pages/8.9/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_9_1.test.describe.configure({ mode: 'parallel' });
+_8_9_1.test.describe('Orchestration Cluster MCP Server - Cluster Tools', () => {
+    const clusterName = 'Agentic Orchestration Cluster';
+    _8_9_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_9_1.test.beforeEach(async ({ page, loginPage }, testInfo) => {
+        await (0, UtilitiesPage_1.loginWithRetry)(page, loginPage, testUser, (testInfo.workerIndex + 1) * 1000);
+    });
+    _8_9_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_9_1.test)(testCase.name, async ({ homePage, appsPage, operateHomePage, operateProcessesPage, operateProcessInstancePage, }) => {
+            _8_9_1.test.slow();
+            await _8_9_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_9_1.test.step(`Verify ${assertion.description}`, async () => {
+                    await operateProcessInstancePage.assertProcessVariableContainsText(testCase.variable, assertion.text);
+                });
+            }
+        });
+    }
+});

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

@@ -5,6 +5,7 @@ const _8_9_1 = require("../../fixtures/8.9");
 const _setup_1 = require("../../test-setup.js");
 const sleep_1 = require("../../utils/sleep");
 const connectorSecrets_1 = require("../../utils/connectorSecrets");
+const mcpSecrets_1 = require("../../utils/mcpSecrets");
 const UtilitiesPage_1 = require("../../pages/8.9/UtilitiesPage");
 const users_1 = require("../../utils/users");
 _8_9_1.test.describe.configure({ mode: 'parallel' });
@@ -51,6 +52,30 @@ _8_9_1.test.describe('Cluster Setup Tests', () => {
             await clusterSecretsPage.createSetOfSecrets(clusterName, connectorSecrets_1.connectorSecretsValues);
         }
     });
+    (0, _8_9_1.test)('Create Agentic Orchestration Cluster', async ({ page, loginPage, homePage, clusterPage, clusterDetailsPage, clusterSecretsPage, }, testInfo) => {
+        _8_9_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_9_1.test)('Create AWS Cluster', async ({ page, loginPage, homePage, clusterPage, clusterDetailsPage, clusterSecretsPage, }, testInfo) => {
         await (0, UtilitiesPage_1.loginWithRetry)(page, loginPage, users_1.testUsers.mainUser, (testInfo.workerIndex + 1) * 1000);
         _8_9_1.test.slow();

package/dist/tests/SM-8.6/connectors-user-flows.spec.js

@@ -5,6 +5,8 @@ const SM_8_6_1 = require("../../fixtures/SM-8.6");
 const _setup_1 = require("../../test-setup.js");
 const UtlitiesPage_1 = require("../../pages/SM-8.6/UtlitiesPage");
 const sleep_1 = require("../../utils/sleep");
+const apiHelpers_1 = require("../../utils/apiHelpers");
+const constants_1 = require("../../utils/constants");
 SM_8_6_1.test.describe.configure({ mode: 'parallel' });
 SM_8_6_1.test.describe('Connectors User Flow Tests', () => {
     SM_8_6_1.test.beforeEach(async ({ navigationPage }, testInfo) => {
@@ -204,8 +206,10 @@ SM_8_6_1.test.describe('Connectors User Flow Tests', () => {
         await SM_8_6_1.test.step('Make Authorization Request', async () => {
             const baseURL = process.env.PLAYWRIGHT_BASE_URL ||
                 `http://gke-${process.env.BASE_URL}.ci.distro.ultrawombat.com`;
-            const response = await request.post(`${baseURL}/connectors/inbound/test-webhook-id${randomString}`);
-            await (0, test_1.expect)(response.status()).toBe(200);
+            await (0, test_1.expect)(async () => {
+                const response = await request.post(`${baseURL}/connectors/inbound/test-webhook-id${randomString}`);
+                await (0, apiHelpers_1.assertResponseStatus)(response, 200);
+            }).toPass(constants_1.defaultAssertionOptions);
             await (0, sleep_1.sleep)(30000);
         });
         await SM_8_6_1.test.step('Assert Diagram Has Successfully Completed in Operate', async () => {

package/dist/utils/apiHelpers.d.ts

@@ -7,14 +7,14 @@ export declare function authAPI(environment: 'saas'): Promise<string>;
 export declare function authAPI(environment: 'sm'): Promise<string>;
 export declare function authAPI(environment: 'saas', audience?: string): Promise<string>;
 export declare function authAPI(environment: 'sm', audience?: string): Promise<string>;
-export declare function authSaasAPI(audience?: string): Promise<string>;
+export declare function authSaasAPI(audience?: string, clusterType?: string): Promise<string>;
 export declare function authSmAPI(): Promise<string>;
 export declare function authC8runAPI(name: string, password: string): Promise<void>;
 export declare function validateMcpServerHealth(serverUrl?: string): Promise<APIResponse>;
-export declare function deployProcess(filePath: string, authToken?: string, environment?: 'saas' | 'sm'): Promise<number | null>;
-export declare function createProcessInstance(processDefinitionKey: string, authToken?: string, environment?: 'saas' | 'sm'): Promise<string>;
-export declare function createJsonClusterVariable(authToken?: string, environment?: 'saas' | 'sm', customVariableName?: string, customVariableValue?: string): Promise<void>;
-export declare function createStringClusterVariable(authToken?: string, environment?: 'saas' | 'sm', customVariableName?: string, customVariableValue?: string): Promise<void>;
+export declare function deployProcess(filePath: string, authToken?: string, environment?: 'saas' | 'sm', clusterType?: string): Promise<number | null>;
+export declare function createProcessInstance(processDefinitionKey: string, authToken?: string, environment?: 'saas' | 'sm', clusterType?: string): Promise<string>;
+export declare function createJsonClusterVariable(authToken?: string, environment?: 'saas' | 'sm', customVariableName?: string, customVariableValue?: string, clusterType?: string): Promise<void>;
+export declare function createStringClusterVariable(authToken?: string, environment?: 'saas' | 'sm', customVariableName?: string, customVariableValue?: string, clusterType?: string): Promise<void>;
 /**
  * @deprecated This function will be removed when SM-8.9 cluster variables test is updated.
  * Use createJsonClusterVariable() for JSON variables or

package/dist/utils/apiHelpers.js

@@ -45,6 +45,29 @@ async function sendRequestAndAssertResponse(request, url, requestBody, maxRetrie
     }
 }
 exports.sendRequestAndAssertResponse = sendRequestAndAssertResponse;
+// ---- Cluster Credentials Helper ----
+function getClusterCredentials(clusterType) {
+    if (!clusterType) {
+        return {
+            clientId: process.env.ZEEBE_API_CLIENT_ID,
+            clientSecret: process.env.ZEEBE_API_CLIENT_SECRET,
+            authUrl: process.env.ZEEBE_API_AUTH_URL,
+            apiUrl: process.env.ZEEBE_API_URL,
+            tokenAudience: process.env.ZEEBE_API_TOKEN_AUDIENCE,
+        };
+    }
+    const suffix = clusterType.toUpperCase().replace(/[\s-]/g, '_');
+    const clientId = process.env[`ZEEBE_API_CLIENT_ID_${suffix}`];
+    const clientSecret = process.env[`ZEEBE_API_CLIENT_SECRET_${suffix}`];
+    const authUrl = process.env[`ZEEBE_API_AUTH_URL_${suffix}`];
+    const apiUrl = process.env[`ZEEBE_API_URL_${suffix}`];
+    const tokenAudience = process.env[`ZEEBE_API_TOKEN_AUDIENCE_${suffix}`];
+    if (!clientId || !clientSecret || !authUrl || !apiUrl || !tokenAudience) {
+        throw new Error(`Credentials for cluster type "${clusterType}" not found. ` +
+            `Expected env vars: ZEEBE_API_CLIENT_ID_${suffix}, etc.`);
+    }
+    return { clientId, clientSecret, authUrl, apiUrl, tokenAudience };
+}
 // ---- Zeebe: URL building (SaaS vs SM) ----
 function inferZeebeEnvironment(override) {
     if (override) {
@@ -65,8 +88,13 @@ function normalizeOrigin(value, defaultProtocol = 'https') {
     }
     return `${defaultProtocol}://${trimmed}`;
 }
-function getZeebeApiOrigin(environment) {
+function getZeebeApiOrigin(environment, clusterType) {
     if (environment === 'saas') {
+        // Use cluster-specific credentials if clusterType provided
+        if (clusterType) {
+            const creds = getClusterCredentials(clusterType);
+            return creds.apiUrl.replace(/\/+$/, '');
+        }
         const saasUrl = process.env.ZEEBE_API_URL?.trim();
         if (!saasUrl) {
             throw new Error('Missing ZEEBE_API_URL (SaaS).');
@@ -79,9 +107,9 @@ function getZeebeApiOrigin(environment) {
     }
     throw new Error('Missing BASE_URL (SM).');
 }
-function buildZeebeApiUrl(resourcePath, environmentOverride) {
+function buildZeebeApiUrl(resourcePath, environmentOverride, clusterType) {
     const environment = inferZeebeEnvironment(environmentOverride);
-    const baseUrl = getZeebeApiOrigin(environment);
+    const baseUrl = getZeebeApiOrigin(environment, clusterType);
     const normalizedPath = resourcePath.startsWith('/')
         ? resourcePath
         : `/${resourcePath}`;
@@ -136,8 +164,28 @@ async function authAPI(environment, audience = process.env.ZEEBE_API_TOKEN_AUDIE
     return bearerToken;
 }
 exports.authAPI = authAPI;
-async function authSaasAPI(audience = process.env.ZEEBE_API_TOKEN_AUDIENCE) {
-    return authAPI('saas', audience);
+async function authSaasAPI(audience, clusterType) {
+    const creds = getClusterCredentials(clusterType);
+    const tokenAudience = audience ?? creds.tokenAudience;
+    apiRequestContext = await getApiRequestContext();
+    const tokenResponse = await apiRequestContext.post(creds.authUrl, {
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        data: {
+            audience: tokenAudience,
+            client_id: creds.clientId,
+            client_secret: creds.clientSecret,
+            grant_type: 'client_credentials',
+        },
+    });
+    if (tokenResponse.status() !== 200) {
+        const errorBody = await tokenResponse.text();
+        throw new Error(`Failed to fetch access token. Response: ${errorBody}`);
+    }
+    const tokenJson = await tokenResponse.json();
+    const bearerToken = `Bearer ${tokenJson.access_token}`;
+    return bearerToken;
 }
 exports.authSaasAPI = authSaasAPI;
 async function authSmAPI() {
@@ -179,7 +227,7 @@ async function validateMcpServerHealth(serverUrl) {
 }
 exports.validateMcpServerHealth = validateMcpServerHealth;
 // ---- Zeebe: API helpers ----
-async function deployProcess(filePath, authToken, environment) {
+async function deployProcess(filePath, authToken, environment, clusterType) {
     try {
         apiRequestContext = await getApiRequestContext();
         const fileContent = fs_1.default.readFileSync(filePath);
@@ -195,7 +243,7 @@ async function deployProcess(filePath, authToken, environment) {
             mimeType,
             buffer: fileContent,
         };
-        const url = buildZeebeApiUrl('/v2/deployments', environment);
+        const url = buildZeebeApiUrl('/v2/deployments', environment, clusterType);
         const response = await apiRequestContext.post(url, {
             headers: {
                 Authorization: authToken ?? '',
@@ -221,9 +269,9 @@ async function deployProcess(filePath, authToken, environment) {
     }
 }
 exports.deployProcess = deployProcess;
-async function createProcessInstance(processDefinitionKey, authToken, environment) {
+async function createProcessInstance(processDefinitionKey, authToken, environment, clusterType) {
     apiRequestContext = await getApiRequestContext();
-    const url = buildZeebeApiUrl('/v2/process-instances', environment);
+    const url = buildZeebeApiUrl('/v2/process-instances', environment, clusterType);
     const response = await apiRequestContext.post(url, {
         headers: {
             Authorization: authToken ?? '',
@@ -242,10 +290,10 @@ async function createProcessInstance(processDefinitionKey, authToken, environmen
     return String(processInstanceKey);
 }
 exports.createProcessInstance = createProcessInstance;
-async function createClusterVariableInternal(authToken, environment, variableName, variableValue, variableType) {
+async function createClusterVariableInternal(authToken, environment, variableName, variableValue, variableType, clusterType) {
     try {
         apiRequestContext = await getApiRequestContext();
-        const url = buildZeebeApiUrl('/v2/cluster-variables/global', environment);
+        const url = buildZeebeApiUrl('/v2/cluster-variables/global', environment, clusterType);
         const response = await apiRequestContext.post(url, {
             headers: {
                 Authorization: authToken,
@@ -276,18 +324,18 @@ async function createClusterVariableInternal(authToken, environment, variableNam
         throw new Error(`Unexpected error creating ${variableType} cluster variable "${variableName}": ${errorMessage}`);
     }
 }
-async function createJsonClusterVariable(authToken, environment = 'saas', customVariableName, customVariableValue) {
+async function createJsonClusterVariable(authToken, environment = 'saas', customVariableName, customVariableValue, clusterType) {
     const variableName = customVariableName ?? String(process.env.CLUSTER_VARIABLE_NAME);
     const variableValue = customVariableValue
         ? JSON.parse(customVariableValue)
         : JSON.parse(process.env.CLUSTER_VARIABLE_JSON);
-    await createClusterVariableInternal(authToken ?? '', environment, variableName, variableValue, 'JSON');
+    await createClusterVariableInternal(authToken ?? '', environment, variableName, variableValue, 'JSON', clusterType);
 }
 exports.createJsonClusterVariable = createJsonClusterVariable;
-async function createStringClusterVariable(authToken, environment = 'saas', customVariableName, customVariableValue) {
+async function createStringClusterVariable(authToken, environment = 'saas', customVariableName, customVariableValue, clusterType) {
     const variableName = customVariableName ?? String(process.env.CLUSTER_VARIABLE_STRING_NAME);
     const variableValue = customVariableValue ?? process.env.CLUSTER_VARIABLE_STRING_VALUE;
-    await createClusterVariableInternal(authToken ?? '', environment, variableName, variableValue, 'String');
+    await createClusterVariableInternal(authToken ?? '', environment, variableName, variableValue, 'String', clusterType);
 }
 exports.createStringClusterVariable = createStringClusterVariable;
 /**

package/dist/utils/mcpSecrets.d.ts

@@ -0,0 +1,11 @@
+export type McpCredentials = {
+    baseURL: string;
+    clientID: string;
+    clientSecret: string;
+    OauthURL: string;
+    tokenAudience: string;
+};
+export declare function mcpSecretsValues(credentials: McpCredentials): {
+    name: string;
+    value: string;
+}[];

package/dist/utils/mcpSecrets.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpSecretsValues = void 0;
+function mcpSecretsValues(credentials) {
+    return [
+        { name: 'MCP_BASE_URL', value: credentials.baseURL },
+        { name: 'MCP_CLIENT_ID', value: credentials.clientID },
+        { name: 'MCP_CLIENT_SECRET', value: credentials.clientSecret },
+        { name: 'MCP_OAUTH_URL', value: credentials.OauthURL },
+        { name: 'MCP_TOKEN_AUDIENCE', value: credentials.tokenAudience },
+    ];
+}
+exports.mcpSecretsValues = mcpSecretsValues;

package/package.json

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