looprs-core 0.5.0

Domain types, ports, and macros for looprs
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

//! UserOutput port — abstraction over user-facing terminal/UI output.

// TODO: hex refactor Phase 1 — Agent currently calls ui::* static functions
// directly. Replace with this port. Wire the terminal adapter in looprs-cli;
// inject NullOutput in tests.

/// Port: emit structured output to the user.
///
/// Implementations may render to a terminal, a log file, a TUI widget,
/// or a machine-readable JSON stream.
pub trait UserOutput: Send + Sync {
    fn info(&self, msg: &str);
    fn warn(&self, msg: &str);
    fn error(&self, msg: &str);
    fn assistant_text(&self, text: &str);
    fn tool_call(&self, tool_name: &str, input_preview: &str);
    fn tool_ok(&self);
    fn tool_err(&self, err_msg: &str);

    /// Emit a single streaming chunk of assistant text.
    ///
    /// Called once per token/chunk during streaming inference. The default
    /// implementation delegates to `assistant_text`, so existing adapters
    /// remain valid until they opt into incremental rendering.
    fn write_chunk(&self, chunk: &str) {
        self.assistant_text(chunk);
    }
}