previa-runner-0.0.7 has been yanked.

`previa-runner`

Rustdoc-style crate documentation.

Crate Purpose

previa-runner is the remote execution API. It receives E2E/load requests, runs pipelines through previa-engine, and streams SSE events.

Runtime Configuration

Variable	Default	Description
`ADDRESS`	`0.0.0.0`	Bind address
`PORT`	`7373`	Bind port
`RUST_LOG`	unset	Tracing filter

Quick Start

ADDRESS=0.0.0.0 PORT=55880 RUST_LOG=info cargo run -p previa-runner

You can also download prebuilt binaries at: https://previa.dev/downloads

HTTP API Surface

Base URL: http://localhost:55880

Pipeline rule: every step.url must be an absolute URL (http:// or https://).

GET /health
GET /info
GET /openapi.json
POST /api/v1/tests/e2e
POST /api/v1/tests/load

Request Models

E2E

{
  "pipeline": { "name": "E2E", "steps": [] },
  "selectedBaseUrlKey": null,
  "specs": []
}

Load

{
  "pipeline": { "name": "Load", "steps": [] },
  "config": { "totalRequests": 100, "concurrency": 10, "rampUpSeconds": 5 },
  "selectedBaseUrlKey": null,
  "specs": []
}

SSE Event Contracts

E2E sequence

execution:init
step:start
step:result
pipeline:complete

Load sequence

execution:init
metrics (repeated)
complete

Transaction Header

x-transaction-id is propagated and echoed by middleware.

Error Contract

{
  "error": "bad_request",
  "message": "description"
}

Curl Example

curl -N http://localhost:55880/api/v1/tests/e2e \
  -H 'content-type: application/json' \
  -d '{"pipeline":{"name":"E2E","steps":[{"id":"s1","name":"Status","method":"GET","url":"https://httpbin.org/status/200","headers":{},"body":null,"asserts":[]}]},"selectedBaseUrlKey":null,"specs":[]}'

Module Relationship

main -> runner -> engine

previa-runner 0.0.7

previa-runner