Struct Server 

pub struct Server {
    config_path: PathBuf,
    language: String,
    client: String,
}

One connection’s server: where the configuration is, the language, and who asked.

Fields

config_path: PathBuf

language: String

client: String

The client’s name, from its initialize: the log says who asked what.

Implementations

impl Server

pub fn new(config_path: &Path, language: &str) -> Server

fn session(&self) -> Result<Session, String>

The configuration as it is now: it may change while an agent stays connected. None written yet: Sioul’s defaults, as the window starts; one that cannot be read is said, not taken for none.

pub fn handle(&mut self, text: &str) -> Option<String>

One message in, its answer out: a request gets its response, a notification nothing, even when it fails (JSON-RPC §4.1).

fn dispatch(&mut self, method: &str, params: &Value) -> Result<Value, Failure>

fn initialize(&mut self, params: &Value) -> Value

The handshake: the revision both speak, what Sioul offers, and how to use it.

fn offered(&self) -> Box<dyn Iterator<Item = &'static Tool>>

The tools offered now: the spam filter’s only when the configuration allows them ([mcp] spam), the texts’ only when it asks for them ([mcp] texts); when it cannot be read, all but the texts’ (each call says why).

fn call(&self, params: &Value) -> Result<Value, Failure>

fn run(&self, tool: &Tool, arguments: &Value) -> Result<Answer, String>

A tool run on the configuration as it is now, and logged. A tool that breaks says so to the agent; the server stays up for the next call. Whatever the tool, its lines and its data go out with their account and social security numbers masked, the same in both.

fn read_resource(&self, params: &Value) -> Result<Value, Failure>