ripl-tui 0.3.3

ripl — a living, breathing TUI framework for AI chat in the shell.
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

use std::sync::mpsc;
use std::sync::Arc;

use crate::config::{resolve_provider_key, resolve_provider_name, Config};
use serde::{Deserialize, Serialize};

mod anthropic;
mod openai;
mod openrouter;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum Role {
    System,
    User,
    Assistant,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Message {
    pub role: Role,
    pub content: String,
}

#[derive(Debug, Clone)]
pub enum ApiResponse {
    TokenChunk { token: String },
    TurnComplete,
    Error { message: String },
    Exit,
}

pub trait Provider: Send + Sync + 'static {
    fn stream(&self, messages: &[Message], tx: mpsc::Sender<ApiResponse>);
    /// Called when the user issues a slash command not handled by the app.
    /// Provider streams responses via `tx` as if it were a normal turn.
    fn handle_command(&self, _cmd: &str, _tx: mpsc::Sender<ApiResponse>) {}

    /// Optional: return extra help lines to display in response to `/help`.
    /// Default implementation returns an empty slice.
    fn help_lines(&self) -> &[&str] {
        &[]
    }
}

pub enum ProviderKind {
    Anthropic,
    OpenAi,
    OpenRouter,
}

pub struct ProviderResolved {
    pub kind: ProviderKind,
    pub api_key: String,
    pub model: String,
}

impl ProviderResolved {
    pub fn kind_name(&self) -> &'static str {
        match self.kind {
            ProviderKind::Anthropic => "anthropic",
            ProviderKind::OpenAi => "openai",
            ProviderKind::OpenRouter => "openrouter",
        }
    }
}

pub fn resolve_provider(cfg: &Config) -> Option<ProviderResolved> {
    let name = resolve_provider_name(cfg)?;
    let api_key = resolve_provider_key(cfg)?;
    let model = cfg
        .provider
        .as_ref()
        .and_then(|p| p.model.clone())
        .unwrap_or_else(|| {
            match name.as_str() {
                "anthropic" => "claude-sonnet-4-6",
                "openai" => "gpt-4o-mini",
                "openrouter" => "openai/gpt-4o-mini",
                _ => "default",
            }
            .to_string()
        });

    let kind = match name.as_str() {
        "anthropic" => ProviderKind::Anthropic,
        "openai" => ProviderKind::OpenAi,
        "openrouter" => ProviderKind::OpenRouter,
        _ => return None,
    };

    Some(ProviderResolved { kind, api_key, model })
}

pub fn build_provider(cfg: &Config) -> Option<Arc<dyn Provider>> {
    let resolved = resolve_provider(cfg)?;
    let provider: Arc<dyn Provider> = match resolved.kind {
        ProviderKind::Anthropic => Arc::new(anthropic::AnthropicProvider {
            api_key: resolved.api_key,
            model: resolved.model,
        }),
        ProviderKind::OpenAi => Arc::new(openai::OpenAiProvider {
            api_key: resolved.api_key,
            model: resolved.model,
        }),
        ProviderKind::OpenRouter => Arc::new(openrouter::OpenRouterProvider {
            api_key: resolved.api_key,
            model: resolved.model,
        }),
    };
    Some(provider)
}