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,
        result: Option<String>,
        truncated: bool,
    },
    AgentFinished {
        outcome: String,
        cost_usd: f64,
        turns: u32,
    },
    AgentGone,
    StorePersistFailed {
        lost_seq: u64,
        detail: String,
    },
    DeadlineSet {
        deadline: String,
    },
    AgentTimedOut {
        deadline: 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.

result: Option<String>

What the tool returned, as display text: caliban’s result_text, the head of the result, bounded (see prospero_core::caliband::stream::TOOL_RESULT_CAP). None for events stored before #236 or a frame that carried no result.

truncated: bool

true when result is only the head of a longer result.

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.

DeadlineSet

The spawn carried a wall-clock timeout; this is the deadline it implies (#221), recorded at spawn so it outlives the replica that set it.

The durable log is the storage: a local timer dies with its replica, while any replica taking the agent over can read this back.

Fields

deadline: String

When the agent must be killed, RFC-3339.

AgentTimedOut

The agent hit its wall-clock deadline and prospero killed it (#221).

Emitted before the kill, so the log says why the killed that follows happened. A distinct kind rather than a new AgentStatus: the status enum is matched exhaustively by clients (Ariel, the dashboard) and by caliban’s own vocabulary, whereas event kinds are the log’s established extension point.

Fields

deadline: String

The deadline it passed, RFC-3339 — the same value the spawn recorded, so the log explains itself without a join.

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 JsonSchema for EventKind

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for EventKind

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

Equality operator ==.

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

Inequality operator !=.

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