Struct ValidatedMessageList 

pub struct ValidatedMessageList { /* private fields */ }

Drop-in Vec replacement that enforces message pair invariants.

All reads (iteration, indexing, len) work through messages(). Mutations are intercepted via validated methods.

Implementations

impl ValidatedMessageList

pub fn new(initial: Option<Vec<ApiMessage>>, strict: bool) -> Self

Create a new validated message list.

If initial is provided, bulk-loads without per-message validation (trusts existing data), then rebuilds pending state.

pub fn messages(&self) -> &[ApiMessage]

Access the underlying messages (read-only).

pub fn into_inner(self) -> Vec<ApiMessage>

Consume self and return the inner Vec.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn pending_tool_ids(&self) -> HashSet<String>

Tool call IDs still awaiting results.

pub fn has_pending_tools(&self) -> bool

True if in EXPECT_TOOL_RESULTS state.

pub fn add_user(&mut self, content: &str)

Append a user message. Auto-completes pending tool results if any.

pub fn add_assistant( &mut self, content: Option<&str>, tool_calls: Option<Vec<Value>>, )

Append assistant message. If tool_calls present, enters EXPECT_TOOL_RESULTS.

pub fn add_tool_result( &mut self, tool_call_id: &str, content: &str, ) -> Result<(), String>

Append tool result. Rejects orphaned IDs not in pending set (in strict mode).

pub fn add_tool_results_batch( &mut self, tool_calls: &[Value], results_by_id: &HashMap<String, String>, )

Batch-add tool results. Fills missing with synthetic errors.

pub fn replace_all(&mut self, messages: Vec<ApiMessage>)

Replace all messages (e.g., after compaction). Rebuilds pending state.