Skip to main content

pixie_pi/agent/
context.rs

1//! Agent context snapshot and event protocol.
2
3use std::sync::Arc;
4
5use serde_json::Value;
6
7use crate::ai::stream::AssistantMessageEvent;
8use crate::ai::types::{AssistantMessage, Message, Usage};
9use crate::agent::tool::AgentTool;
10
11/// A snapshot of agent state passed into the loop. `AgentMessage` here is just
12/// [`Message`] (no custom app messages in this port).
13#[derive(Clone)]
14pub struct AgentContext {
15    pub system_prompt: String,
16    pub messages: Vec<Message>,
17    pub tools: Vec<Arc<dyn AgentTool>>,
18}
19
20impl AgentContext {
21    pub fn new(system_prompt: String, tools: Vec<Arc<dyn AgentTool>>) -> Self {
22        Self {
23            system_prompt,
24            messages: Vec::new(),
25            tools,
26        }
27    }
28
29    /// Look up a tool by name.
30    pub fn find_tool(&self, name: &str) -> Option<&Arc<dyn AgentTool>> {
31        self.tools.iter().find(|t| t.name() == name)
32    }
33}
34
35/// Events emitted by the agent loop for UI updates. Mirrors pi's `AgentEvent`.
36#[derive(Debug, Clone, serde::Serialize)]
37pub enum AgentEvent {
38    AgentStart,
39    AgentEnd {
40        messages: Vec<Message>,
41    },
42    TurnStart,
43    TurnEnd {
44        message: AssistantMessage,
45        tool_results: Vec<crate::ai::types::ToolResultMessage>,
46    },
47    MessageStart(Message),
48    /// Fine-grained streaming event for an in-progress assistant message. The
49    /// renderer applies deltas incrementally (no full-message clone needed).
50    MessageUpdate {
51        event: AssistantMessageEvent,
52    },
53    MessageEnd(Message),
54    ToolExecutionStart {
55        tool_call_id: String,
56        tool_name: String,
57        args: Value,
58    },
59    ToolExecutionEnd {
60        tool_call_id: String,
61        tool_name: String,
62        is_error: bool,
63    },
64    /// Aggregated token usage for the most recent assistant turn.
65    Usage(Usage),
66    /// A fatal agent error (loop could not complete).
67    Error(String),
68}