Troupeby AliveDocsSign in

Reference

runs

Test-run reports a runner publishes and clients follow. Index · shared schemas · errors.

ProcedureSummaryRESTMCP toolStability
runs.publishA test runner publishes reporter events, so the studio and other clients can follow the run. seq MUST be contiguous.POST—experimental
runs.listList recent runs (locally: the last 50, or 24 h)GET—experimental
runs.getRead one run with its per-test resultsGET—experimental
runs.eventsReplay a run's reporter events from since, then follow it liveGET—experimental

runs.publish

A test runner publishes reporter events, so the studio and other clients can follow the run. seq MUST be contiguous.

RESTPOST /v1/runs/publish (input as a JSON body)
RPC/rpc/v2/runs/publish
MCPnot a tool (runner and inspector plumbing); hints: none
Authruns:report
Tenancyproject
Troupe Cloudanswered by the control plane
Stabilityexperimental, since 1.0

Input:

TypeScript
{
  runId: RunId
  events: ReporterEnvelope[]  // 1–500 items
}

Output:

TypeScript
{ acceptedThrough: Seq }

Errors: U, CONFLICT.

Named types: ReporterEnvelope, RunId, Seq.

runs.list

List recent runs (locally: the last 50, or 24 h)

RESTGET /v1/runs/list (input as query parameters)
RPC/rpc/v2/runs/list
MCPnot a tool (runner and inspector plumbing); hints: read-only, idempotent
Authruns:read
Tenancyproject
Troupe Cloudanswered by the control plane
Stabilityexperimental, since 1.0

Input:

TypeScript
{
  status?: RunStatus
  limit?: integer  // default 50; 1–100
  cursor?: Cursor
}

Output:

TypeScript
{ runs: RunSummary[]; nextCursor?: string }

Errors: U.

Named types: Cursor, RunStatus, RunSummary.

runs.get

Read one run with its per-test results

RESTGET /v1/runs/get (input as query parameters)
RPC/rpc/v2/runs/get
MCPnot a tool (runner and inspector plumbing); hints: read-only, idempotent
Authruns:read
Tenancyproject
Troupe Cloudanswered by the control plane
Stabilityexperimental, since 1.0

Input:

TypeScript
{ runId: RunId }

Output:

TypeScript
RunDetail

Errors: U, NOT_FOUND.

Named types: RunDetail, RunId.

runs.events

Replay a run's reporter events from since, then follow it live

RESTGET /v1/runs/events (input as query parameters)
RPC/rpc/v2/runs/events
MCPnot a tool (an event iterator; MCP tools return one result); hints: read-only, idempotent
Authruns:read
Tenancyproject
Troupe Cloudanswered by the control plane
Stabilityexperimental, since 1.0

Input:

TypeScript
{ runId: RunId; since?: Seq }

Output: an event iterator (text/event-stream on REST), each event:

TypeScript
ReporterEnvelopeOut

Errors: U, NOT_FOUND.

Named types: ReporterEnvelopeOut, RunId, Seq.

esc

    Type to search every page, the protocol reference and the cloud API.