Struct CompactionUpdate 

#[non_exhaustive]
pub struct CompactionUpdate {
    pub compaction_id: CompactionId,
    pub status: CompactionStatus,
    pub summary: MaybeUndefined<Vec<ContentBlock>>,
    pub error: MaybeUndefined<String>,
    pub meta: MaybeUndefined<Map<String, Value>>,
}

Available on crate feature unstable_protocol_v2 only.

A context compaction upsert. The first notification fixes the compaction’s timeline position. Later updates with the same ID patch that entity in place.

summary, error, and _meta have patch semantics: omission leaves the stored value unchanged, null clears it, and a concrete value replaces it. summary: [] also clears the summary. A concrete _meta object patches the stored metadata by top-level key instead of replacing it.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

compaction_id: CompactionId

The Agent-owned ID of this compaction, unique within the session.

status: CompactionStatus

Current lifecycle status.

summary: MaybeUndefined<Vec<ContentBlock>>

Complete replacement user-displayable summary content for the compaction.

error: MaybeUndefined<String>

Human-readable error details for the compaction.

meta: MaybeUndefined<Map<String, Value>>

The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Omitted leaves the stored metadata unchanged; null clears it. An object patches the stored metadata by top-level key: keys it omits are unchanged, a key set to null is removed, and any other value replaces that key’s stored value without merging nested objects. Beyond this patch rule, implementations MUST NOT make assumptions about values at these keys.

See protocol docs: Metadata Patches

Implementations

impl CompactionUpdate

pub fn new( compaction_id: impl Into<CompactionId>, status: CompactionStatus, ) -> CompactionUpdate

Builds a compaction update with optional patch fields omitted.

pub fn summary( self, summary: impl IntoMaybeUndefined<Vec<ContentBlock>>, ) -> CompactionUpdate

Sets, clears, or omits the complete retained summary patch.

pub fn error(self, error: impl IntoMaybeUndefined<String>) -> CompactionUpdate

Sets, clears, or omits the error details patch.

pub fn meta( self, meta: impl IntoMaybeUndefined<Map<String, Value>>, ) -> CompactionUpdate

Patches, clears, or leaves unchanged compaction metadata.

A concrete object patches stored metadata by top-level key; see apply_meta_update.

Trait Implementations

impl Clone for CompactionUpdate

fn clone(&self) -> CompactionUpdate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompactionUpdate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompactionUpdate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CompactionUpdate

impl JsonSchema for CompactionUpdate

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 CompactionUpdate

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CompactionUpdate

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 CompactionUpdate