cicd_fluent_test
Destructive
Run and monitor ServiceNow ATF tests via sn_cicd API. Supports running test suites or individual tests, tracking progress, and fetching results.
Instructions
Run or inspect ServiceNow ATF tests through the sn_cicd API (SDK v4.10.0+). Set target to "testsuite" or "test" and action to "run" (start it), "watch" (follow a progressId from a previous run), or "result" (fetch a resultId). Identify a suite by testSuiteSysId or testSuiteName, a test by testSysId or testName. action="run" executes real ATF steps on the instance and the records those steps touch change; "watch" and "result" only read. No Fluent project required. Requires instance authentication (auto-injected from session, or pass auth explicitly).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auth | No | Credential alias to use for authentication with instance (auto-injected from session if not provided) | |
| wait | No | Wait for completion, polling progress (CLI default true). Set false to return immediately with the progress id, then follow up with action="watch". Not accepted when action="result". | |
| debug | No | Print debug output | |
| action | Yes | Operation: "run" to start, "watch" to follow a progressId from a previous run, or "result" to fetch a resultId. | |
| osName | No | Operating system to run UI-based tests on. Only with target="testsuite", action="run". | |
| output | No | Output format: "json" or "raw". Defaults to "json" (machine-readable envelope). | |
| select | No | Dot/bracket path to extract from the output (e.g. "result.interpretedResult.summary.testStatus" or "result.rollup_results[0].status"). Implies machine-readable output. | |
| target | Yes | What to act on: "testsuite" (an ATF test suite) or "test" (a single ATF test). | |
| resultId | No | Result sys_id to fetch. REQUIRED when action="result". For a suite this is the links.results.id from run; for a test it is the resultId from watch. | |
| testName | No | Name of the ATF test to run; resolved to a sys_id before starting. Fails if the name matches zero or more than one test. Mutually exclusive with testSysId. | |
| osVersion | No | Operating system version to run UI-based tests on. Only with target="testsuite", action="run". | |
| testSysId | No | sys_id of the ATF test (sys_atf_test) to run. Mutually exclusive with testName. Use with target="test", action="run". | |
| progressId | No | Progress id returned by a previous run. REQUIRED when action="watch". | |
| runInCloud | No | Run UI-based steps on the ATF Cloud Runner instead of a manual/scheduled client runner. Only with action="run". | |
| browserName | No | Browser to run UI-based tests in: any, chrome, firefox, edge, ie, safari. Only with target="testsuite", action="run". | |
| pollTimeout | No | Milliseconds to poll for completion before giving up. CLI default 900000 (15 minutes). Not accepted when action="result". Values above ~15 minutes also require raising FLUENT_MCP_COMMAND_TIMEOUT_MS. | |
| testSuiteName | No | Name of the test suite to run. Mutually exclusive with testSuiteSysId. Use with target="testsuite", action="run". | |
| browserVersion | No | Browser version to run UI-based tests in. Only with target="testsuite", action="run". | |
| testSuiteSysId | No | sys_id of the test suite to run. Mutually exclusive with testSuiteName. Use with target="testsuite", action="run". | |
| captureNodeLogs | No | Capture node (browser) logs during the run. Only with target="test", action="run". | |
| isPerformanceRun | No | Run the suite as a Performance Test instead of a standard functional test. Only with target="testsuite", action="run". |