Enum AgentStreamChunkKindV1 

pub enum AgentStreamChunkKindV1 {
    Text {
        text: String,
        is_delta: bool,
    },
    Thinking {
        text: String,
    },
    InteractionPrompt {
        correlation_id: String,
        interaction_kind: ProviderInteractionKind,
        tool_name: String,
        title: Option<String>,
        prompt: String,
        options: Vec<AgentStreamInteractionOptionV1>,
    },
    ModeCatalog {
        current: Option<String>,
        available: Vec<AgentStreamNamedIdV1>,
    },
    ConfigOptions {
        options: Vec<ProviderConfigOption>,
    },
    ModelCatalog {
        current: Option<String>,
        available: Vec<AgentStreamNamedIdV1>,
    },
    Blocked {
        correlation_id: Option<String>,
        tool_class: String,
        authority: BlockAuthorityV1,
        reason_kind: Option<String>,
        reason: String,
        help: Option<String>,
    },
}

The kind of a single AgentStreamChunkV1 – content the operator needs to act on a running ACP session: what the agent is saying, a pending interaction it needs answered, and the catalogs the three ACP setter verbs (SetSessionMode, SetSessionConfigOption, SetSessionModel) operate over. Mirrors gate4agent_types::ProviderEvent’s content variants deliberately – see docs/gate4agent/plans/gate4agent-acp-control-plane-on-the-wire-2026-09-02.md §3-4.

Variants

Text

Fields

text: String

is_delta: bool

Thinking

Fields

text: String

InteractionPrompt

The correlation_id correlation::interaction_correlation mints for the interaction – the same id a client deriving telemetry from NodeEvent::Control computes – plus the question and option list NodeRequest::ResolveInteraction answers blind without.

Fields

correlation_id: String

interaction_kind: ProviderInteractionKind

tool_name: String

title: Option<String>

prompt: String

options: Vec<AgentStreamInteractionOptionV1>

ModeCatalog

Fields

current: Option<String>

available: Vec<AgentStreamNamedIdV1>

ConfigOptions

Mirrors gate4agent_types::ProviderConfigOption verbatim rather than inventing a second shape for the same content.

Fields

options: Vec<ProviderConfigOption>

ModelCatalog

Fields

current: Option<String>

available: Vec<AgentStreamNamedIdV1>

Blocked

An action a provider or the host refused, with who refused it (authority), why (reason_kind/reason) and what to do about it (help). BlockAuthorityV1’s doc comment explains why authority is never guessed. An EVENT, not state: a session that reconnects mid-block does not get this replayed to it – the same seeded-state- vs-unreplayed-event split the agent stream already draws for Text/ Thinking/InteractionPrompt.

Fields

correlation_id: Option<String>

tool_class: String

authority: BlockAuthorityV1

reason_kind: Option<String>

reason: String

help: Option<String>

Implementations

impl AgentStreamChunkKindV1

pub fn validate(&self) -> Result<(), &'static str>

Trait Implementations

impl Clone for AgentStreamChunkKindV1

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentStreamChunkKindV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentStreamChunkKindV1

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AgentStreamChunkKindV1

impl PartialEq for AgentStreamChunkKindV1

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AgentStreamChunkKindV1

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AgentStreamChunkKindV1