Enum RunEvent 

pub enum RunEvent {
    Stdout {
        payload: String,
    },
    Stderr {
        payload: String,
    },
    Transcript {
        agent_id: Option<String>,
        kind: String,
        payload: Value,
    },
    ToolCall {
        call_id: String,
        name: String,
        args: Value,
        started_at: String,
    },
    ToolResult {
        call_id: String,
        ok: bool,
        result: Value,
    },
    Hook {
        name: String,
        phase: String,
        payload: Value,
    },
    PersonaStage {
        persona: String,
        stage: String,
        transition: String,
    },
    PackRun {
        bundle_hash: String,
        signature_verified: bool,
        key_id: Option<String>,
        cache_hit: bool,
        dry_run_verify: bool,
    },
}

One observable event from a running pipeline. Variants are #[serde(tag = "event_type")] so wire consumers (notably the CLI --json NDJSON stream) can discriminate without inspecting the payload shape.

Variants

Stdout

Bytes written to stdout (raw, including any trailing newlines).

Fields

payload: String

Stderr

Bytes written to stderr (raw, including any trailing newlines).

Fields

payload: String

Transcript

One append on a transcript stream (agent.transcript.llm topic). kind mirrors the transcript entry’s type field.

Fields

agent_id: Option<String>

kind: String

payload: Value

ToolCall

A model-issued tool call. call_id matches the transcript call_id; agents reconcile Self::ToolCall / Self::ToolResult pairs by it.

Fields

call_id: String

name: String

args: Value

started_at: String

RFC 3339 timestamp captured at emission.

ToolResult

Outcome of a tool call.

Fields

call_id: String

ok: bool

result: Value

Hook

A workflow hook fired during the run.

Fields

name: String

phase: String

payload: Value

PersonaStage

A persona-stage transition. Mirrors the persona.runtime.events topic; the transition field captures the stage state change ("started", "completed", "handoff", …).

Fields

persona: String

stage: String

transition: String

PackRun

harn run <bundle.harnpack> resolved a pack to execute. Carries the verified bundle hash, whether the embedded Ed25519 signature verified end-to-end, the signing key fingerprint (when signed), and whether the unpacked archive came from the content-addressed cache or was extracted fresh on this run.

Fields

bundle_hash: String

signature_verified: bool

key_id: Option<String>

cache_hit: bool

dry_run_verify: bool

Trait Implementations

impl Clone for RunEvent

fn clone(&self) -> RunEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunEvent

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

Formats the value using the given formatter.

impl Serialize for RunEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.