periplon 0.2.0

Rust SDK for building multi-agent AI workflows and automation
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
118
119
120
121
122
123
124
125
126
127
128

use crate::adapters::secondary::{PromptType, SubprocessCLITransport};
use crate::application::Query;
use crate::domain::Message;
use crate::error::{Error, Result};
use crate::options::AgentOptions;
use futures::{Stream, StreamExt};
use serde_json::json;

pub struct PeriplonSDKClient {
    options: AgentOptions,
    query: Option<Query>,
}

impl PeriplonSDKClient {
    pub fn new(options: AgentOptions) -> Self {
        Self {
            options,
            query: None,
        }
    }

    /// Connect to CLI
    pub async fn connect(&mut self, prompt: Option<String>) -> Result<()> {
        let prompt_type = if let Some(text) = prompt {
            PromptType::String(text)
        } else {
            PromptType::Stream
        };

        let transport = Box::new(SubprocessCLITransport::new(
            prompt_type,
            self.options.clone(),
        ));

        let (mut query, write_rx) = Query::new(
            transport,
            true, // Always streaming mode for PeriplonSDKClient
            self.options.can_use_tool.clone(),
            self.options.hooks.clone(),
        );

        // Connect transport
        {
            let transport_arc = query.transport();
            let mut transport_lock = transport_arc.lock().await;
            transport_lock.connect().await?;
        }

        query.start(write_rx).await?;

        // TODO: Build hooks config and initialize
        // Skip initialization if no hooks configured to avoid hanging
        if self.options.hooks.is_some() && !self.options.hooks.as_ref().unwrap().is_empty() {
            query.initialize(None).await?;
        }

        self.query = Some(query);

        Ok(())
    }

    /// Send a query
    pub async fn query(&mut self, prompt: impl Into<String>) -> Result<()> {
        let query = self.query.as_mut().ok_or(Error::NotConnected)?;

        let message = json!({
            "type": "user",
            "message": {
                "role": "user",
                "content": prompt.into()
            },
            "session_id": "default"
        });

        let json_str = serde_json::to_string(&message)?;
        query.write(format!("{}\n", json_str))?;

        Ok(())
    }

    /// Receive messages
    pub fn receive_messages(&self) -> Result<impl Stream<Item = Message> + '_> {
        let query = self.query.as_ref().ok_or(Error::NotConnected)?;
        Ok(query.receive_messages())
    }

    /// Receive until ResultMessage
    pub fn receive_response(&self) -> Result<impl Stream<Item = Message> + '_> {
        let stream = self.receive_messages()?;

        Ok(async_stream::stream! {
            futures::pin_mut!(stream);
            while let Some(msg) = stream.next().await {
                let is_result = matches!(msg, Message::Result(_));
                yield msg;
                if is_result {
                    break;
                }
            }
        })
    }

    /// Send interrupt
    pub async fn interrupt(&self) -> Result<()> {
        let query = self.query.as_ref().ok_or(Error::NotConnected)?;
        query.interrupt().await
    }

    /// Set permission mode
    pub async fn set_permission_mode(&self, mode: impl Into<String>) -> Result<()> {
        let query = self.query.as_ref().ok_or(Error::NotConnected)?;
        query.set_permission_mode(mode.into()).await
    }

    /// Set model
    pub async fn set_model(&self, model: Option<impl Into<String>>) -> Result<()> {
        let query = self.query.as_ref().ok_or(Error::NotConnected)?;
        query.set_model(model.map(|m| m.into())).await
    }

    /// Disconnect
    pub async fn disconnect(&mut self) -> Result<()> {
        if let Some(mut query) = self.query.take() {
            query.close().await?;
        }
        Ok(())
    }
}