rs-utcp 0.3.2

Rust implementation of the Universal Tool Calling Protocol (UTCP).
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

use std::net::SocketAddr;

use futures_util::{SinkExt, StreamExt};
use rs_utcp::UtcpClientInterface;
use serde_json::json;
use tokio::net::TcpListener;
use tokio_tungstenite::{accept_async, tungstenite::protocol::Message};

#[path = "../common/mod.rs"]
mod common;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let addr = spawn_ws_server().await?;
    println!("Started WS demo at ws://{addr}/tools");

    let client = common::client_from_providers(json!({
        "manual_version": "1.0.0",
        "utcp_version": "0.3.0",
        "allowed_communication_protocols": ["websocket"],
        "info": {
            "title": "WebSocket Demo",
            "version": "1.0.0",
            "description": "WebSocket Demo Manual"
        },
        "tools": [{
            "name": "echo",
            "description": "Echo a message",
            "inputs": { "type": "object" },
            "outputs": { "type": "object" },
            "tool_call_template": {
                "call_template_type": "websocket",
                "name": "ws_demo",
                "url": format!("ws://{addr}/tools")
            }
        }]
    }))
    .await?;
    let tools = client.search_tools("", 10).await?;
    println!(
        "Tools: {:?}",
        tools.iter().map(|t| &t.name).collect::<Vec<_>>()
    );

    let mut args = std::collections::HashMap::new();
    args.insert("message".into(), serde_json::json!("hello ws"));
    let res = client.call_tool("ws_demo.echo", args).await?;
    println!("Result: {}", serde_json::to_string_pretty(&res)?);
    Ok(())
}

async fn spawn_ws_server() -> anyhow::Result<SocketAddr> {
    let listener = TcpListener::bind("127.0.0.1:0").await?;
    let addr = listener.local_addr()?;
    tokio::spawn(async move {
        while let Ok((stream, _)) = listener.accept().await {
            tokio::spawn(async move {
                let mut ws = accept_async(stream).await.expect("ws accept");
                while let Some(msg) = ws.next().await {
                    match msg {
                        Ok(Message::Text(text)) if text == "manual" => {
                            let manifest = json!({
                                "tools": [{
                                    "name": "echo",
                                    "description": "Echo a message",
                                    "inputs": {"type": "object"},
                                    "outputs": {"type": "object"},
                                    "tags": ["ws"]
                                }]
                            });
                            let _ = ws.send(Message::Text(manifest.to_string())).await;
                        }
                        Ok(Message::Text(text)) => {
                            // Echo back parsed JSON
                            let val: serde_json::Value =
                                serde_json::from_str(&text).unwrap_or(json!({}));
                            let _ = ws.send(Message::Text(val.to_string())).await;
                            break;
                        }
                        Ok(Message::Close(_)) | Err(_) => break,
                        _ => {}
                    }
                }
            });
        }
    });
    Ok(addr)
}