agui-rs-server 0.1.1

Server SDK for the AG-UI protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

//! Tool-based generative UI example, ported from
//! `ag-ui-protocol/integrations/server-starter-all-features/python/.../tool_based_generative_ui.py`.
//!
//! On every run the agent emits a single assistant message that carries one
//! `generate_haiku` tool call, then snapshots the full message history.
//! When the most recent user message is the literal string `"thanks"`, the
//! agent instead replies with a plain text confirmation.
//!
//! Run with:
//!   cargo run -p agui-rs-server --example tool_based_generative_ui
//!
//! Then POST to `http://127.0.0.1:8000/`.

use agui_rs_core::types::{AssistantMessage, ToolMessage};
use agui_rs_core::{
    factory, Event, FunctionCall, Message, MessagesSnapshotEvent, Result, RunAgentInput,
    ToolCall, ToolCallKind, UserMessageContent,
};
use agui_rs_server::{agui_router, channel, serve, RunHandler};
use futures::stream::BoxStream;
use serde_json::json;

struct ToolBasedGenerativeUiHandler;

#[async_trait::async_trait]
impl RunHandler for ToolBasedGenerativeUiHandler {
    async fn handle(&self, input: RunAgentInput) -> Result<BoxStream<'static, Result<Event>>> {
        let (emitter, stream) = channel(32);

        let last_user_text = input
            .messages
            .iter()
            .rev()
            .find_map(|message| match message {
                Message::User(user) => match &user.content {
                    UserMessageContent::Text(text) => Some(text.clone()),
                    _ => None,
                },
                _ => None,
            });

        let thread_id = input.thread_id.clone();
        let run_id = input.run_id.clone();
        let history = input.messages.clone();

        tokio::spawn(async move {
            let _ = emitter.run_started(&thread_id, &run_id).await;

            let mut all_messages = history;

            if matches!(last_user_text.as_deref(), Some("thanks")) {
                let assistant = Message::Assistant(AssistantMessage {
                    id: format!("msg-{}-assistant", run_id),
                    content: Some("Haiku created".into()),
                    name: None,
                    tool_calls: None,
                    encrypted_value: None,
                });
                all_messages.push(assistant);
            } else {
                let tool_call_id = format!("tc-{}-haiku", run_id);
                let assistant = Message::Assistant(AssistantMessage {
                    id: format!("msg-{}-assistant", run_id),
                    content: None,
                    name: None,
                    tool_calls: Some(vec![ToolCall {
                        id: tool_call_id.clone(),
                        kind: ToolCallKind::Function,
                        function: FunctionCall {
                            name: "generate_haiku".into(),
                            arguments: json!({
                                "japanese": ["エーアイの", "橋つなぐ道", "コパキット"],
                                "english": [
                                    "From AI's realm",
                                    "A bridge-road linking us-",
                                    "CopilotKit."
                                ]
                            })
                            .to_string(),
                        },
                        encrypted_value: None,
                    }]),
                    encrypted_value: None,
                });
                let tool_result = Message::Tool(ToolMessage {
                    id: format!("msg-{}-tool", run_id),
                    content: "Haiku created".into(),
                    tool_call_id,
                    error: None,
                    encrypted_value: None,
                });
                all_messages.push(assistant);
                all_messages.push(tool_result);
            }

            let _ = emitter
                .emit(Event::MessagesSnapshot(MessagesSnapshotEvent {
                    messages: all_messages,
                    base: Default::default(),
                }))
                .await;

            let _ = emitter
                .emit(factory::run_finished(&thread_id, &run_id))
                .await;
        });

        Ok(stream)
    }
}

#[tokio::main]
async fn main() -> Result<()> {
    let app = agui_router(ToolBasedGenerativeUiHandler);
    println!("tool_based_generative_ui listening on http://127.0.0.1:8000/");
    serve("127.0.0.1:8000", app).await
}