Expand description
Typed parameters for the sealed operations that take them.
§Why these are types and not Vec<(&str, String)>
The untyped form is still there — crate::core::CoreClient::call takes
wire-named pairs, and always will, because that is what makes an operation
this crate never named still reachable. But a pair list is checked against
the contract at runtime: a misspelled payolad is refused when the call
is made, which is late for a name that was wrong the moment it was typed.
These structs move the spelling to compile time and leave the runtime check
exactly where it was, as the backstop for the untyped route.
§Why a request enum is closed and a response string is not
super’s models keep status and kind as String because an added
variant must never fail a decode. A request parameter is the opposite
situation: the value is the client’s to choose, the contract declares the
closed set the server accepts, and a value outside it is a 400 the client
could have prevented. So where the document declares an enum, this module
declares one too — and super::coverage holds the two together.
Structs§
- Export
Session Params GET /v1/sessions/{id}/export— one session’s export stream.- Export
Sessions Params GET /v1/sessions/export— every session in a window, streamed.- Search
Spans Params GET /v1/search/spans— semantic search over span embeddings.- Session
List Params GET /v1/sessions— the sessions listing.- Session
Traces Params GET /v1/sessions/{id}/traces— the derived span read model.- Skills
List Params GET /v1/skills— the skills listing.- Stats
Params GET /v1/stats— the aggregate rollups.- Trace
List Params GET /v1/traces— the trace summaries for one session.- Trace
Params GET /v1/traces/{trace_id}— one trace with its spans.
Enums§
- Export
Detail - The grain an export is written at.
- Payload
Detail - How much of a span’s payload a trace read should carry.
- Skill
Scope - Whose skills a listing covers.
- Skill
Sort - How a skills listing is ordered.
- Sort
Direction - Which way a listing is ordered.
Traits§
- Contract
Enum - A parameter whose accepted values the contract closes with an
enum. - Contract
Params - One operation’s parameters, in the shape the contract declares them.