Enum EventKind 

pub enum EventKind {
    AgentSpawned,
    AgentDiscovered,
    AgentInit {
        model: String,
        tools: Vec<String>,
        session_id: String,
    },
    StatusChanged {
        from: AgentStatus,
        to: AgentStatus,
    },
    Output {
        stream: OutputStream,
        chunk: String,
    },
    ToolStarted {
        id: String,
        name: String,
        input: Value,
    },
    ToolFinished {
        id: String,
        name: String,
        ok: bool,
    },
    AgentFinished {
        outcome: String,
        cost_usd: f64,
        turns: u32,
    },
    AgentGone,
    StorePersistFailed {
        lost_seq: u64,
        detail: String,
    },
    RepoHealth {
        state: WorkspaceHealth,
    },
}

The semantic payload of a fleet event.

Variants

AgentSpawned

Prospero asked caliband to spawn this agent.

AgentDiscovered

A poll discovered an agent Prospero had not seen before.

AgentInit

The agent’s stream emitted its init frame.

Fields

model: String

Model the agent is running.

tools: Vec<String>

Tools available to the agent.

session_id: String

Caliban session id.

StatusChanged

A poll observed a lifecycle transition.

Fields

from: AgentStatus

Prior status.

to: AgentStatus

New status.

Output

A chunk of streamed output.

Fields

stream: OutputStream

Which stream the chunk belongs to.

chunk: String

The text chunk.

ToolStarted

A tool call started.

Fields

id: String

Caliban’s tool_use_id, correlating this start with its [ToolFinished]. #[serde(default)] for pre-#106 stored events, which predate this field (they carry only name).

name: String

Tool name (e.g. “Read”).

input: Value

Tool input (opaque JSON).

ToolFinished

A tool call finished.

Fields

id: String

Caliban’s tool_use_id, correlating this finish with its [ToolStarted]. Caliban’s ToolCallEnd carries the id but not the name, so consumers pair on the id. #[serde(default)] for pre-#106 stored events.

name: String

Tool name. Empty in practice — caliban’s ToolCallEnd omits it; the name is on the matching [ToolStarted]. Kept for wire compatibility.

ok: bool

Whether the tool succeeded.

AgentFinished

The agent finished; carries the final accounting.

Fields

outcome: String

Result subtype (e.g. “success”, “max_turns”, “budget_exceeded”).

cost_usd: f64

Total run cost in USD.

turns: u32

Number of turns taken.

AgentGone

A poll observed the agent disappear from caliband’s registry.

StorePersistFailed

A durable-store append failed, so the event with lost_seq reached the live bus but is absent from durable history. This marker is itself persisted (best-effort) so a history reader — not just a log scraper — sees that the live and durable views diverged here. See ADR-0004.

Fields

lost_seq: u64

The seq of the event that could not be persisted.

detail: String

Rendered append error, for diagnosis.

RepoHealth

A workspace’s caliband health changed. (Variant name kept as RepoHealth for event-store wire compatibility; the payload type is the renamed WorkspaceHealth, whose serialization is unchanged.)

Fields

state: WorkspaceHealth

The new health state.

Trait Implementations

impl Clone for EventKind

fn clone(&self) -> EventKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EventKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EventKind

fn deserialize<__D>( __deserializer: __D, ) -> Result<EventKind, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EventKind

fn eq(&self, other: &EventKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EventKind

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EventKind