Crate solti_api 

solti-api - task management API.

Dual-transport API layer exposing task operations over gRPC and HTTP. Both transports share the same wire types generated from proto/solti/v1/*.proto and delegate to an ApiHandler implementation.

feature	transport	module
grpc	tonic gRPC server	SoltiApiService, SoltiApiServer
http	axum HTTP/JSON	HttpApi

Quick start

let adapter = SupervisorApiAdapter::new(supervisor);
let svc     = SoltiApiServer::new(SoltiApiService::new(Arc::new(adapter)));
let router  = HttpApi::new(Arc::new(adapter)).router();

Also

• ApiHandler transport-agnostic trait with 6 operations.
• ApiError unified error type mapped to gRPC Status / HTTP JSON.
• SupervisorApiAdapter default adapter bridging to SupervisorApi.

Re-exports

pub use tonic;

pub use axum;

Structs

HttpApi

HTTP API service builder.

NoOpApiMetrics

Zero-cost default implementation.

SoltiApiServer

SoltiApi provides task management on the agent side. The control-plane acts as a client calling into the agent.

SoltiApiService

gRPC service wrapping an ApiHandler.

SupervisorApiAdapter

Adapter that bridges SupervisorApi to ApiHandler.

Enums

ApiError

Transport

Transport label value — bounded cardinality by construction.

Constants

API_VERSION

Current API protocol version.

MAX_REQUEST_BYTES

Maximum accepted request body / message size for both HTTP and gRPC transports. 4 MiB.

Traits

ApiHandler

Task execution API handler.

ApiMetricsBackend

Metrics backend for the API layer.

Functions

build_grpc_server

Build a configured SoltiApiServer with no-op metrics.

build_grpc_server_with_metrics

Build a configured SoltiApiServer with an explicit metrics backend.

http_metrics_middleware

Axum middleware that records per-request HTTP metrics.

noop_api_metrics

Construct a no-op handle: convenient default.

to_tonic_server_tls

Convert solti_tls::ServerTlsConfig into tonic::transport::ServerTlsConfig.

Type Aliases

ApiMetricsHandle

Shareable handle used throughout this crate.

OutputEventStream

Boxed stream of OutputEvents — the wire-side surface of live task logs.