toolresults

v2026.04.23.1

Google Cloud toolresults infrastructure models

Repository

https://github.com/systeminit/swamp-extensions

Platforms

linux-x86_64 linux-aarch64 darwin-x86_64 darwin-aarch64

Labels

gcpgoogle-cloudtoolresultscloudinfrastructure

models

Quality score

Verified by Swamp

How well-documented and verifiable this extension is.

Grade A

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types1/1earned
Has description1/1earned
At least one platform tag (or universal)1/1earned
Two or more platform tags (or universal)1/1earned
License declared1/1earned
Verified public repository2/2earned

Install

$ swamp extension pull @swamp/gcp/toolresults

@swamp/gcp/toolresults/historiesv2026.04.23.1histories.ts

Global Arguments

Argument	Type	Required	Description
displayName?	string	no	A short human-readable (plain text) name to display in the UI. Maximum of 100 characters. - In response: present if set during create. - In create request: optional
historyId?	string	no	A unique identifier within a project for this History. Returns INVALID_ARGUMENT if this field is set or overwritten by the caller. - In response always set - In create request: never set
name?	string	no	A name to uniquely identify a history within a project. Maximum of 200 characters. - In response always set - In create request: always set
testPlatform?	enum	no	The platform of the test history. - In response: always set. Returns the platform of the last execution if unknown.
requestId?	string	no	A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.

createCreate a histories

getGet a histories

Argument	Type	Required	Description
identifier	string	yes	The name of the histories

syncSync histories state from GCP

Resources

state(infinite)— A History represents a sorted list of Executions ordered by the start_timesta...

@swamp/gcp/toolresults/histories-executionsv2026.04.23.1histories_executions.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
completionTime?	object	no	A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one. All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap second table is needed for interpretation, using a [24-hour linear smear](https://develope
creationTime?	object	no	A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one. All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap second table is needed for interpretation, using a [24-hour linear smear](https://develope
dimensionDefinitions?	array	no	The dimensions along which different steps in this execution may vary. This must remain fixed over the life of the execution. Returns INVALID_ARGUMENT if this field is set in an update request. Returns INVALID_ARGUMENT if the same name occurs in more than one dimension_definition. Returns INVALID_ARGUMENT if the size of the list is over 100. - In response: present if set by create - In create request: optional - In update request: never set
executionId?	string	no	A unique identifier within a History for this Execution. Returns INVALID_ARGUMENT if this field is set or overwritten by the caller. - In response always set - In create/update request: never set
outcome?	object	no	Interprets a result so that humans and machines can act on it.
specification?	object	no	The details about how to run the execution.
state?	enum	no	The initial state is IN_PROGRESS. The only legal state transitions is from IN_PROGRESS to COMPLETE. A PRECONDITION_FAILED will be returned if an invalid transition is requested. The state can only be set to COMPLETE once. A FAILED_PRECONDITION will be returned if the state is set to COMPLETE multiple times. If the state is set to COMPLETE, all the in-progress steps within the execution will be set as COMPLETE. If the outcome of the step is not set, the outcome will be set to INCONCLUSIVE. - In r
testExecutionMatrixId?	string	no	TestExecution Matrix ID that the TestExecutionService uses. - In response: present if set by create - In create: optional - In update: never set
historyId	string	yes	A History id. Required.
requestId?	string	no	A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.

createCreate a executions

getGet a executions

Argument	Type	Required	Description
identifier	string	yes	The name of the executions

updateUpdate executions attributes

syncSync executions state from GCP

Resources

state(infinite)— An Execution represents a collection of Steps. For instance, it could represe...

@swamp/gcp/toolresults/histories-executions-clustersv2026.04.23.1histories_executions_clusters.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)

getGet a clusters

Argument	Type	Required	Description
identifier	string	yes	The name of the clusters

syncSync clusters state from GCP

Resources

state(infinite)— Retrieves a single screenshot cluster by its ID

@swamp/gcp/toolresults/histories-executions-environmentsv2026.04.23.1histories_executions_environments.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)

getGet a environments

Argument	Type	Required	Description
identifier	string	yes	The name of the environments

syncSync environments state from GCP

Resources

state(infinite)— An Environment represents the set of test runs (Steps) from the parent Execut...

@swamp/gcp/toolresults/histories-executions-stepsv2026.04.23.1histories_executions_steps.ts

Global Arguments

Argument	Type	Required	Description
completionTime?	object	no	A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one. All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap second table is needed for interpretation, using a [24-hour linear smear](https://develope
creationTime?	object	no	A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one. All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap second table is needed for interpretation, using a [24-hour linear smear](https://develope
description?	string	no	A description of this tool For example: mvn clean package -D skipTests=true - In response: present if set by create/update request - In create/update request: optional
deviceUsageDuration?	object	no	A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years.
dimensionValue?	array	no	If the execution containing this step has any dimension_definition set, then this field allows the child to specify the values of the dimensions. The keys must exactly match the dimension_definition of the execution. For example, if the execution has `dimension_definition = ['attempt', 'device']` then a step must define values for those dimensions, eg. `dimension_value = ['attempt': '1', 'device': 'Nexus 6']` If a step does not participate in one dimension of the matrix, the value for that dimen
hasImages?	boolean	no	Whether any of the outputs of this step are images whose thumbnails can be fetched with ListThumbnails. - In response: always set - In create/update request: never set
labels?	array	no	Arbitrary user-supplied key/value pairs that are associated with the step. Users are responsible for managing the key namespace such that keys don't accidentally collide. An INVALID_ARGUMENT will be returned if the number of labels exceeds 100 or if the length of any of the keys or values exceeds 100 characters. - In response: always set - In create request: optional - In update request: optional; any new key/value pair will be added to the map, and any new value for an existing key will update
multiStep?	object	no	Details when multiple steps are run with the same configuration as a group.
name?	string	no	A short human-readable name to display in the UI. Maximum of 100 characters. For example: Clean build A PRECONDITION_FAILED will be returned upon creating a new step if it shares its name and dimension_value with an existing step. If two steps represent a similar action, but have different dimension values, they should share the same name. For instance, if the same set of tests is run on two different platforms, the two steps should have the same name. - In response: always set - In create reque
outcome?	object	no	Interprets a result so that humans and machines can act on it.
runDuration?	object	no	A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years.
state?	enum	no	The initial state is IN_PROGRESS. The only legal state transitions are * IN_PROGRESS -> COMPLETE A PRECONDITION_FAILED will be returned if an invalid transition is requested. It is valid to create Step with a state set to COMPLETE. The state can only be set to COMPLETE once. A PRECONDITION_FAILED will be returned if the state is set to COMPLETE multiple times. - In response: always set - In create/update request: optional
stepId?	string	no	A unique identifier within a Execution for this Step. Returns INVALID_ARGUMENT if this field is set or overwritten by the caller. - In response: always set - In create/update request: never set
testExecutionStep?	object	no	A step that represents running tests. It accepts ant-junit xml files which will be parsed into structured test results by the service. Xml file paths are updated in order to append more files, however they can't be deleted. Users can also add test results manually by using the test_result field.
toolExecutionStep?	object	no	Generic tool step to be used for binaries we do not explicitly support. For example: running cp to copy artifacts from one location to another.
historyId	string	yes	Required. A History id.
executionId	string	yes	Required. An Execution id.
requestId?	string	no	A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.

createCreate a steps

getGet a steps

Argument	Type	Required	Description
identifier	string	yes	The name of the steps

updateUpdate steps attributes

syncSync steps state from GCP

accessibility_clustersaccessibility clusters

get_perf_metrics_summaryget perf metrics summary

publish_xunit_xml_filespublish xunit xml files

Argument	Type	Required	Description
xunitXmlFiles?	any	no

Resources

state(infinite)— A Step represents a single operation performed as part of Execution. A step c...

@swamp/gcp/toolresults/histories-executions-steps-perfsampleseriesv2026.04.23.1histories_executions_steps_perfsampleseries.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
basicPerfSampleSeries?	object	no	Encapsulates the metadata for basic sample series represented by a line chart
executionId?	string	no	A tool results execution ID. @OutputOnly
historyId?	string	no	A tool results history ID. @OutputOnly
projectId?	string	no	The cloud project @OutputOnly
sampleSeriesId?	string	no	A sample series id @OutputOnly
stepId?	string	no	A tool results step ID. @OutputOnly

createCreate a perfSampleSeries

getGet a perfSampleSeries

Argument	Type	Required	Description
identifier	string	yes	The name of the perfSampleSeries

syncSync perfSampleSeries state from GCP

Resources

state(infinite)— Resource representing a collection of performance samples (or data points)

@swamp/gcp/toolresults/histories-executions-steps-perfsampleseries-samplesv2026.04.23.1histories_executions_steps_perfsampleseries_samples.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)

getGet a samples

Argument	Type	Required	Description
identifier	string	yes	The name of the samples

syncSync samples state from GCP

batch_createbatch create

Argument	Type	Required	Description
perfSamples?	any	no

Resources

state(infinite)— Resource representing a single performance measure or data point

@swamp/gcp/toolresults/histories-executions-steps-testcasesv2026.04.23.1histories_executions_steps_testcases.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)

getGet a testCases

Argument	Type	Required	Description
identifier	string	yes	The name of the testCases

syncSync testCases state from GCP

Resources

state(infinite)— Gets details of a Test Case for a Step. Experimental test cases API. Still in...

@swamp/gcp/toolresults/histories-executions-steps-thumbnailsv2026.04.23.1histories_executions_steps_thumbnails.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)

getGet a thumbnails

Argument	Type	Required	Description
identifier	string	yes	The name of the thumbnails

syncSync thumbnails state from GCP

Resources

state(infinite)— An image, with a link to the main image and a thumbnail.

@swamp/gcp/toolresults

Repository

Platforms

Labels

Contents

Quality score

Install

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Release Notes

Release Notes

Release Notes

Release Notes

@swamp/gcp/toolresults

Repository

Platforms

Labels

Contents

Quality score

Install

Models9

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Previous Versions5

Release Notes

Release Notes

Release Notes

Release Notes