opendev-web 0.1.4

Web backend (axum + WebSocket) for OpenDev AI coding agent
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

//! Commands API routes.
//!
//! Exposes the list of available slash commands to the web UI,
//! matching the Python `opendev.web.routes.commands` module.

use axum::routing::get;
use axum::{Json, Router};

use crate::state::AppState;

/// Build the commands router.
pub fn router() -> Router<AppState> {
    Router::new()
        .route("/api/commands", get(list_commands))
        .route("/api/commands/help", get(get_help))
}

/// Get the static list of available commands grouped by category.
fn command_list() -> serde_json::Value {
    serde_json::json!([
        {
            "category": "Operations",
            "commands": [
                {
                    "name": "/mode",
                    "args": "<name>",
                    "description": "Switch mode: normal or plan"
                },
                {
                    "name": "/init",
                    "args": "[path]",
                    "description":
                        "Analyze codebase and generate AGENTS.md with repository guidelines"
                }
            ]
        },
        {
            "category": "Session Management",
            "commands": [
                {
                    "name": "/clear",
                    "args": "",
                    "description": "Clear current session context"
                }
            ]
        },
        {
            "category": "Configuration",
            "commands": [
                {
                    "name": "/models",
                    "args": "",
                    "description":
                        "Interactive model/provider selector (use \u{2191}/\u{2193} arrows to choose)"
                }
            ]
        },
        {
            "category": "MCP (Model Context Protocol)",
            "commands": [
                {
                    "name": "/mcp list",
                    "args": "",
                    "description": "List configured MCP servers"
                },
                {
                    "name": "/mcp connect",
                    "args": "<name>",
                    "description": "Connect to an MCP server"
                },
                {
                    "name": "/mcp disconnect",
                    "args": "<name>",
                    "description": "Disconnect from a server"
                },
                {
                    "name": "/mcp tools",
                    "args": "[<name>]",
                    "description": "Show available tools from server(s)"
                },
                {
                    "name": "/mcp test",
                    "args": "<name>",
                    "description": "Test connection to a server"
                }
            ]
        },
        {
            "category": "General",
            "commands": [
                {
                    "name": "/help",
                    "args": "",
                    "description": "Show help message"
                },
                {
                    "name": "/exit",
                    "args": "",
                    "description": "Exit OpenDev"
                }
            ]
        }
    ])
}

/// List available commands.
async fn list_commands() -> Json<serde_json::Value> {
    Json(command_list())
}

/// Get help text with commands.
async fn get_help() -> Json<serde_json::Value> {
    Json(serde_json::json!({
        "title": "Available Commands",
        "commands": command_list(),
        "note": "Type commands in the chat input to execute them",
    }))
}

#[cfg(test)]
#[path = "commands_tests.rs"]
mod tests;