Module wire 

caliband’s control-plane wire types.

These are caliban’s own definitions, re-exported from the published caliban-contract crate (#239): serde-only, no daemon internals, so it is not the wide coupling ADR-0003 rejected — that was caliban-supervisor, the whole daemon. ADR-0003’s “revisit if” clause called for exactly this once hand-mirroring became a drift source, and it had: the mirror never learned caliban’s AgentStatus::Drained (caliban ADR 0057), so a single drained agent failed the entire Listed reply.

What stays here is what has no upstream home: AttachInbound (caliban’s per-agent attach protocol, not part of the control-plane contract) and the boundary conversion to prospero’s own domain crate::model::AgentStatus, which is prospero’s public API vocabulary and deliberately not caliban’s type.

Structs

AgentRecord

Snapshot describing a registered sub-agent.

DaemonStatus

Daemon status returned by CtlRequest::Status.

DrainedAgent

One agent drained by a CtlRequest::Drain — its id plus the resume reference (session directory) the caller records to bring it back (#650, ADR 0057).

SpawnSpec

Parameters for a new sub-agent spawn. The supervisor stores this so respawn can reuse it.

Enums

AgentStatus

Lifecycle state of an agent. Mirrors caliban’s AgentStatus wire enum exactly so the same value round-trips through both protocols.

AttachInbound

Inbound control frames written to an interactive agent’s per-agent socket. Mirrors caliban AttachInbound (caliban/src/attach.rs); the outbound stream stays caliban stream-json, so the two never share a direction.

CtlReply

Control-plane replies.

CtlRequest

Control-plane requests from the CLI / parent agent to the daemon.

DriveProtocol

Which wire protocol a driver uses to reach an agent over its per-agent network listener (ADR 0059, #675). Selected per spawn; the worker serves one or the other on its single TLS+token listener, never both at once.

Endpoint

Where a caliband socket lives, independent of transport family.

PermissionPosture

How a session handles tool calls that need permission (#238).

SupervisorError

Errors the supervisor reports back to clients.

WireAgentStatus

caliban’s lifecycle enum, as it appears on the wire. Converted to prospero’s crate::model::AgentStatus at the boundary by domain_status — the two are separate on purpose: prospero’s is the vocabulary its own API and dashboard speak. Lifecycle state of a registered sub-agent.

WirePermissionPosture

caliban’s permission posture, as it appears on the wire. Prospero’s own crate::model::PermissionPosture (#238) is what the API and CR use. Per-session permission posture carried on a SpawnSpec (ADR 0059).

Traits

EndpointExt

Prospero’s accessor on caliban’s Endpoint.

Functions

domain_status

Map caliban’s wire status onto prospero’s domain status.

wire_posture

Map prospero’s domain posture onto caliban’s wire posture (#238).

wire_status

Map prospero’s domain status onto caliban’s wire status.