Struct Item 

pub struct Item {
    pub id: Option<MessageId>,
    pub kind: ItemKind,
    pub parts: Vec<Part>,
    pub metadata: BTreeMap<String, Value>,
}

A single entry in the agent transcript.

An Item represents one message or event in the conversation between the system, user, assistant, and tools. Each item has a kind that determines its role and a vector of Parts that carry its content.

Items are the primary unit of data flowing through the agentkit loop: callers submit user and system items, the loop appends assistant and tool items, and compaction strategies operate on the full Vec<Item> transcript.

Example

use agentkit_core::{Item, ItemKind};

let user_msg = Item::text(ItemKind::User, "List the workspace crates.");

assert_eq!(user_msg.kind, ItemKind::User);
assert_eq!(user_msg.parts.len(), 1);

Fields

id: Option<MessageId>

Optional provider-assigned or user-supplied message identifier.

kind: ItemKind

The role of this item in the transcript.

parts: Vec<Part>

The content parts that make up this item.

metadata: BTreeMap<String, Value>

Arbitrary key-value metadata for this item.

Implementations

impl Item

pub fn new(kind: ItemKind, parts: Vec<Part>) -> Item

Builds an item with the given role and parts.

pub fn text(kind: ItemKind, text: impl Into<String>) -> Item

Builds a single-text-part item.

pub fn with_id(self, id: impl Into<MessageId>) -> Item

Sets the item identifier.

pub fn with_metadata(self, metadata: BTreeMap<String, Value>) -> Item

Replaces the item metadata.

pub fn push_part(self, part: Part) -> Item

Appends one part to the item.

Trait Implementations

impl Clone for Item

fn clone(&self) -> Item

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Item

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Item

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ItemView for Item

fn kind(&self) -> ItemKind

Returns the role of this item.

fn parts(&self) -> &[Part]

Returns the content parts.

fn metadata(&self) -> &BTreeMap<String, Value>

Returns the metadata map.

impl PartialEq for Item

fn eq(&self, other: &Item) -> 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 Item

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 Item