Reference

traces

Trace chunks the runtime records for the test framework. Index · shared schemas · errors.

Procedure	Summary	REST	MCP tool	Stability
`traces.startChunk`	Start recording `device.trace` for this session. At most one chunk is active at a time.	`POST`	—	stable
`traces.stopChunk`	Stop the chunk. `discard` drops it (a passing test under `retain-on-failure`). `finalSnapshot` takes a last screenshot and a11y tree first.	`POST`	—	stable

Start recording device.trace for this session. At most one chunk is active at a time.


REST	`POST /v1/traces/start-chunk` (input as a JSON body)
RPC	`/rpc/v2/traces/startChunk`
MCP	not a tool (runner and inspector plumbing); hints: none
Auth	`devices:read`
Tenancy	`project`
Troupe Cloud	relayed through the host agent to the device host’s runtime
Stability	stable, since 1.0

Input:

TypeScript

{ sessionId: SessionId; title?: Label; capture?: TraceCapture }

Output:

TypeScript

{ chunkId: TraceChunkId; startedAt: string }

Errors: S, CONFLICT.

Stop the chunk. discard drops it (a passing test under retain-on-failure). finalSnapshot takes a last screenshot and a11y tree first.


REST	`POST /v1/traces/stop-chunk` (input as a JSON body)
RPC	`/rpc/v2/traces/stopChunk`
MCP	not a tool (runner and inspector plumbing); hints: none
Auth	`devices:read`
Tenancy	`project`
Troupe Cloud	relayed through the host agent to the device host’s runtime
Stability	stable, since 1.0

Input:

TypeScript

{
  sessionId: SessionId
  chunkId: TraceChunkId
  discard?: boolean  // default false
  finalSnapshot?: boolean  // default false
}

Output:

TypeScript

{ chunkId: TraceChunkId; events: integer; file?: FileRef }

Errors: S.