routerctl 0.3.6

Command-line control interface for syntrop-routerd
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
129
130
131
132
133
134
135
136
137
138
139

use clap::{Args, Parser, Subcommand};
use std::path::PathBuf;

#[derive(Parser, Debug)]
#[command(name = "routerctl")]
#[command(author = "Syntropd Authors")]
#[command(version)]
#[command(about = "Operator control CLI for syntrop-routerd")]
pub struct Cli {
    #[arg(short, long, default_value = "/run/syntrop/io.syntrop.Router1", global = true)]
    pub socket: PathBuf,

    #[arg(long, default_value = "http://127.0.0.1:32768", global = true)]
    pub http_url: String,

    #[arg(long, global = true)]
    pub json: bool,

    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand, Debug)]
pub enum Commands {
    /// Show daemon status, memory RSS, active requests, and PSI metrics
    Status,

    /// Inspect and test LLM providers
    Providers(ProvidersArgs),

    /// List connected provider models
    Models,

    /// Show or set the default model (pinned first when eligible)
    Default(DefaultArgs),

    /// Simulate routing decision and score breakdown
    Route(RouteArgs),

    /// Benchmark router latency and Time-To-First-Token (TTFT)
    Test(TestArgs),

    /// Introspect Varlink interfaces and IDL specifications
    Info(InfoArgs),

    /// Verify providers live and enable only what answers
    Setup(SetupArgs),
}

#[derive(Args, Debug)]
pub struct ProvidersArgs {
    #[command(subcommand)]
    pub command: ProvidersCommands,
}

#[derive(Subcommand, Debug)]
pub enum ProvidersCommands {
    /// List configured providers and health status
    List,

    /// Test connectivity and latency of provider(s)
    Test {
        /// Specific provider ID to test (tests all if omitted)
        provider_id: Option<String>,
    },
}

#[derive(Args, Debug)]
pub struct RouteArgs {
    /// Target model name (or 'router:fast', 'router:hard', 'auto')
    #[arg(default_value = "router:fast")]
    pub model: String,

    /// Difficulty tier ('fast' or 'hard')
    #[arg(short, long)]
    pub tier: Option<String>,

    /// Estimated context tokens (prompt + output)
    #[arg(long, default_value_t = 1024)]
    pub tokens: usize,

    /// Simulate streaming request
    #[arg(long)]
    pub stream: bool,
}

#[derive(Args, Debug)]
pub struct TestArgs {
    /// Model to test
    #[arg(short, long, default_value = "router:fast")]
    pub model: String,

    /// Benchmark prompt to send
    #[arg(short, long, default_value = "Respond with one short sentence acknowledging this benchmark test.")]
    pub prompt: String,

    /// Difficulty tier ('fast' or 'hard')
    #[arg(short, long)]
    pub tier: Option<String>,
}

#[derive(Args, Debug)]
pub struct DefaultArgs {
    /// Model to pin as default (omit to show the current default)
    pub model: Option<String>,

    /// Path to routerd configuration file
    #[arg(long, default_value = "/etc/syntrop/routerd.toml")]
    pub config: PathBuf,

    /// Skip systemctl service reload
    #[arg(long)]
    pub no_reload: bool,
}

#[derive(Args, Debug)]
pub struct InfoArgs {
    /// Specific interface to inspect (e.g. io.syntrop.Router1)
    pub interface: Option<String>,
}

#[derive(Args, Debug, Clone)]
pub struct SetupArgs {
    /// Path to routerd configuration file
    #[arg(long, default_value = "/etc/syntrop/routerd.toml")]
    pub config: PathBuf,

    /// Directory for downloaded/staged models
    #[arg(long, default_value = "/var/lib/models")]
    pub models_dir: PathBuf,

    /// Skip systemctl service reload
    #[arg(long)]
    pub no_reload: bool,

    /// Non-interactive: skip prompts, auto-pick the first live model
    #[arg(long)]
    pub auto: bool,
}