internal/

Package adapters implements protocol adapters (HTTP first) behind a common step interface, each emitting per-phase spans and classifying the outcome.

Package agent is the target-metrics agent's protocol: the wire type both the standalone agent binary (cmd/flowbench-agent) and the engine's poller share, the OS-level host sampling behind it, the HTTP server the agent exposes, and the client-side poller the engine uses to correlate a target's resource use with a run (ADR 0016, issue #32).

Package auth applies a step's declared credentials to the outgoing request.

Package collector streams spans into the two storage tiers (folded aggregates and raw trace trees), applies redaction, evaluates thresholds and soak trends, and classifies the stress knee as degraded or throttled.

Package data loads fixture files into rows and dispenses them to concurrent consumers under a distribution and exhaustion policy.

Package eval evaluates extractions and assertions against a protocol response, independent of any adapter.

Package executor runs scenarios as a goroutine-per-VU pool, accepting only the canonical flow IR and delegating protocol work to the adapters.

Package grpcstub serves a .proto with handlers that speak JSON.

Package ir defines the canonical flow IR: the single structure both authoring surfaces compile to and the only input the executor accepts.

Package parser turns authoring inputs (YAML files; IR from the Python SDK) into the validated canonical flow IR, reporting problems as pre-run errors with file/line context.

Package planner converts a profile into a VU schedule: the concurrency curve over time, the arrival model, the stop condition, and any self-imposed arrival cap.

Package report renders run artifacts as HTML: flame graphs from folded aggregates and waterfalls from raw trace trees.

Package secret tracks the values that must never reach storage.

Package server is the results server embedded in the flowbench binary: a read-only view over a run store, bound to localhost (ADR 0004).

Package span defines the atomic unit of tracing: a named, timed node with children.

Package store owns the run store: a directory of run artifacts with an index that holds everything the results server shows.

Package target turns a target config into the run-time safety gate: the default base URL relative calls resolve against, and the host allow-list that refuses, before any request is sent, a flow reaching outside the declared base URLs.

Package version records the toolkit's build identity, stamped at release via -ldflags -X.