Generates a HyperExecute YAML configuration for running tests on TestMu AI's HyperExecute platform.
REQUIRED fields: project (language, framework) and testing (testDiscovery.command, testRunnerCommand)
All other fields are OPTIONAL.
Supports multiple languages and frameworks:
- JavaScript/TypeScript: Playwright, Cypress, WebDriverIO, Puppeteer, Taiko
- Python: Pytest, Behave, Robot Framework
- Java: TestNG, JUnit, Cucumber
- Ruby: RSpec, Capybara
- C#: NUnit, xUnit, MSTest
- Mobile (ONLY use appTesting for these): XCUI (iOS), Espresso (Android), Appium
Features:
- Smart framework defaults for common configurations
- Input validation with security checks
- Caching and artifact upload configuration
- Git integration via sourcePayload
- Mobile app testing support (via optional appTesting field)
The appTesting field applies to mobile app testing only; web automation (Selenium, Playwright, Cypress, etc.) leaves it out.
View input schema
{
"type": "object",
"properties": {
"project": {
"type": "object",
"description": "Project configuration",
"properties": {
"language": {
"type": "string",
"description": "Programming language",
"enum": [
"javascript",
"typescript",
"python",
"java",
"ruby",
"csharp",
"go",
"php"
]
},
"framework": {
"type": "string",
"description": "Test framework",
"enum": [
"playwright",
"cypress",
"selenium",
"webdriverio",
"puppeteer",
"taiko",
"pytest",
"behave",
"robot",
"testng",
"junit",
"cucumber",
"rspec",
"capybara",
"nunit",
"xunit",
"mstest",
"xcui",
"espresso",
"appium"
]
},
"buildTool": {
"type": "string",
"description": "Build tool (optional, will be inferred)",
"enum": [
"npm",
"yarn",
"pnpm",
"maven",
"gradle",
"pip",
"bundler",
"dotnet"
]
}
},
"required": [
"language",
"framework"
]
},
"testing": {
"type": "object",
"description": "Test configuration",
"properties": {
"testDiscovery": {
"type": "object",
"description": "How HyperExecute finds the tests to run",
"properties": {
"command": {
"type": "string",
"description": "Command to discover tests (e.g., find tests -name '*.spec.ts')"
},
"type": {
"type": "string",
"description": "How tests are discovered: raw runs the command as given, automatic lets HyperExecute detect them",
"enum": [
"raw",
"automatic"
],
"default": "raw"
},
"mode": {
"type": "string",
"description": "dynamic discovers tests on the runner at run time; static uses the list found before the run",
"enum": [
"dynamic",
"static"
],
"default": "dynamic"
}
},
"required": [
"command"
]
},
"testRunnerCommand": {
"type": "string",
"description": "Command to run tests. Use $test placeholder for test identifier."
}
},
"required": [
"testDiscovery",
"testRunnerCommand"
]
},
"execution": {
"type": "object",
"description": "Execution settings (optional)",
"properties": {
"os": {
"type": "string",
"description": "Runner operating system",
"enum": [
"linux",
"win",
"mac"
],
"default": "linux"
},
"concurrency": {
"type": "integer",
"description": "Number of tests run in parallel",
"minimum": 1,
"maximum": 150,
"default": 4
},
"autosplit": {
"type": "boolean",
"description": "Spread the discovered tests across the parallel runners automatically",
"default": true
},
"retryOnFailure": {
"type": "boolean",
"description": "Retry failed tests",
"default": false
},
"maxRetries": {
"type": "integer",
"description": "Retries per failed test when retryOnFailure is on",
"minimum": 1,
"maximum": 5
},
"globalTimeout": {
"type": "integer",
"description": "Global timeout in minutes"
},
"testSuiteTimeout": {
"type": "integer",
"description": "Test suite timeout in minutes"
},
"tunnel": {
"type": "boolean",
"description": "Enable LambdaTest tunnel"
}
}
},
"setup": {
"type": "object",
"description": "Setup configuration (optional)",
"properties": {
"preCommands": {
"type": "array",
"description": "Commands to run before tests (e.g., npm install)",
"items": {
"type": "string"
}
},
"postCommands": {
"type": "array",
"description": "Commands to run after tests",
"items": {
"type": "string"
}
},
"cacheKey": {
"type": "string",
"description": "Cache key pattern"
},
"cacheDirectories": {
"type": "array",
"description": "Directories to cache",
"items": {
"type": "string"
}
},
"env": {
"type": "object",
"description": "Environment variables",
"additionalProperties": {
"type": "string"
}
},
"runtime": {
"type": "object",
"description": "Runtime configuration",
"properties": {
"language": {
"type": "string",
"description": "Runtime to install on the runner, e.g. node, python, java"
},
"version": {
"type": "string",
"description": "Runtime version, e.g. 20 or 3.11"
}
}
}
}
},
"appTesting": {
"type": "object",
"description": "Mobile app testing configuration (XCUI, Espresso or Appium). Web automation (Selenium, Playwright, Cypress, etc.) leaves it out.",
"properties": {
"framework": {
"type": "string",
"description": "Mobile testing framework (required if appTesting is used)",
"enum": [
"xcui",
"espresso",
"appium"
]
},
"appPath": {
"type": "string",
"description": "Path to app file or lt:// URL"
},
"testSuitePath": {
"type": "string",
"description": "Path to test suite"
},
"devices": {
"type": "array",
"description": "Target devices (required if appTesting is used, e.g., 'iPhone 14 Pro-17')",
"items": {
"type": "string"
}
},
"video": {
"type": "boolean",
"description": "Record a video of each test"
},
"deviceLog": {
"type": "boolean",
"description": "Capture device logs"
},
"networkLog": {
"type": "boolean",
"description": "Capture network logs"
}
}
},
"sourcePayload": {
"type": "object",
"description": "Git integration: fetches the test code from a remote Git repository. Only needed when the code is not already present locally; local code (the usual case) leaves it out.",
"properties": {
"platform": {
"type": "string",
"description": "Source platform; git is the only supported value",
"enum": [
"git"
]
},
"link": {
"type": "string",
"description": "Repository URL"
},
"ref": {
"type": "string",
"description": "Branch/tag/commit"
},
"accessToken": {
"type": "string",
"description": "Reference to an environment variable that holds the Git token, e.g. ${GIT_TOKEN}; never the token itself"
},
"gitProvider": {
"type": "string",
"description": "Git host of the repository",
"enum": [
"github",
"gitlab",
"bitbucket",
"azure"
]
}
},
"required": [
"platform",
"link",
"ref"
]
},
"artifacts": {
"type": "object",
"description": "Artifact configuration (optional)",
"properties": {
"uploadPaths": {
"type": "array",
"description": "Paths on the runner to upload as job artifacts, e.g. reports/ or screenshots/",
"items": {
"type": "string"
}
},
"mergeArtifacts": {
"type": "boolean",
"description": "Merge the artifacts from all parallel runners into one set",
"default": true
},
"reports": {
"type": "array",
"description": "Report configurations for result parsing",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Report FORMAT (not framework name). Use 'xml' for most frameworks (Playwright, Cypress, pytest, TestNG, JUnit generate XML reports). Use 'json' for Cucumber/BDD. Valid: html, json, xml, zip",
"enum": [
"html",
"json",
"xml",
"zip"
]
},
"location": {
"type": "string",
"description": "Path to report files"
},
"frameworkName": {
"type": "string",
"description": "Framework name for display (e.g., 'Playwright', 'pytest') - NOT the report format"
}
},
"required": [
"type",
"location"
]
}
}
}
},
"jobLabel": {
"type": "array",
"description": "Labels for the job",
"items": {
"type": "string"
}
},
"advanced": {
"type": "object",
"description": "Advanced overrides (escape hatch for any HyperExecute field)",
"additionalProperties": true
}
},
"required": [
"project",
"testing"
]
}