airy 0.1.1

Airy is an AI tool for interacting with databases.
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

pub use openai_api_rs::{
    realtime::types::{FunctionType, ToolChoice},
    v1::{
        chat_completion::{
            ChatCompletionMessage, ChatCompletionRequest, ChatCompletionResponse, Content,
            MessageRole, Tool, ToolChoiceType, ToolType,
        },
        types::{Function, FunctionParameters, JSONSchemaType},
    },
};
use reqwest::{
    Client as RequestClient,
    header::{HeaderMap, HeaderValue},
};
use rmcp::model::Tool as McpTool;

use crate::error::AppResult;

pub struct Client {
    base_url: String,
    client: RequestClient,
    tools: Vec<Tool>,
}

impl Client {
    pub fn create(base_url: String, api_key: String) -> AppResult<Self> {
        let mut headers = HeaderMap::new();
        headers.insert(
            "Authorization",
            HeaderValue::from_str(&format!("Bearer {}", api_key.trim())).unwrap(),
        );
        let client = reqwest::Client::builder()
            .default_headers(headers)
            .build()?;
        Ok(Self {
            base_url,
            client,
            tools: Vec::new(),
        })
    }

    pub fn add_tool(&mut self, tool: McpTool) {
        self.tools.push(Tool {
            r#type: ToolType::Function,
            function: Function {
                name: tool.name.to_string(),
                description: if tool.description.is_empty() {
                    None
                } else {
                    Some(tool.description.to_string())
                },
                // Not sure what's the correct way to handle "void" functions.
                parameters: {
                    if tool.input_schema.is_empty()
                        || tool.input_schema.get("title")
                            == Some(&serde_json::Value::String("EmptyObject".into()))
                    {
                        FunctionParameters {
                            schema_type: JSONSchemaType::Object,
                            properties: Some(Default::default()),
                            required: None,
                        }
                    } else {
                        serde_json::from_value(tool.schema_as_json_value()).unwrap()
                    }
                },
            },
        });
    }

    pub async fn chat_completion(
        &self,
        mut req: ChatCompletionRequest,
    ) -> AppResult<ChatCompletionResponse> {
        if !self.tools.is_empty() {
            req = req.tools(self.tools.clone());
        }

        // Intentionally not using OpenAI's client from `openai_api_rs` in case custom parsing is needed.
        // OpenRouter's models are not guaranteed to follow the same schema.
        let res = self
            .client
            .post(format!("{}/chat/completions", self.base_url))
            .json(&req)
            .send()
            .await?
            .error_for_status()?;

        let text = res.text().await.unwrap_or_else(|_| "".to_string());
        Ok(serde_json::from_str(&text)?)
    }
}