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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
use clap::{Args, Parser, Subcommand};
use clap_complete::Shell;
use crate::output::OutputFormat;
#[derive(Debug, Parser)]
#[command(
name = "teams",
version,
about = "Microsoft Teams from your terminal, for humans and agents",
after_help = "Get started:\n teams init Guided setup\n teams tui --demo Explore without an account\n teams doctor Diagnose configuration and access\n teams schema --command 'messages send'\n Inspect the automation contract"
)]
pub struct Cli {
/// Config profile to use
#[arg(long, global = true, env = "TEAMS_PROFILE")]
pub profile: Option<String>,
/// Output format; auto is text on a terminal and JSON when piped
#[arg(short = 'o', long, global = true, value_enum, default_value = "auto")]
pub output: OutputFormat,
/// Suppress progress and informational messages
#[arg(long, global = true)]
pub quiet: bool,
/// Alias for --output json
#[arg(long, global = true, hide = true)]
pub json: bool,
#[command(subcommand)]
pub command: Option<Command>,
}
#[derive(Debug, Subcommand)]
pub enum Command {
/// Guided Microsoft Entra app and account setup
Init(InitArgs),
/// Manage delegated Microsoft authentication
Auth {
#[command(subcommand)]
command: AuthCommand,
},
/// Inspect resolved, secret-free configuration
Config {
#[command(subcommand)]
command: ConfigCommand,
},
/// Show the signed-in Microsoft 365 identity
Whoami,
/// List teams joined by the signed-in user
List(OffsetPageArgs),
/// Work with team channels
Channels {
#[command(subcommand)]
command: ChannelsCommand,
},
/// Work with one-to-one and group chats
Chats {
#[command(subcommand)]
command: ChatsCommand,
},
/// Read and send messages
Messages {
#[command(subcommand)]
command: MessagesCommand,
},
/// Open the keyboard-first terminal interface
Tui(TuiArgs),
/// Check configuration, credential storage, and Graph access
Doctor,
/// Describe supported and deliberately unsupported capabilities
Capabilities,
/// Emit the offline CLI Spec v0.3 contract
Schema {
#[arg(long)]
command: Option<String>,
},
/// Generate shell completions
Completions { shell: Shell },
}
#[derive(Debug, Args)]
pub struct InitArgs {
/// Override the maintained teams-cli public-client application ID
#[arg(long, env = "TEAMS_CLIENT_ID")]
pub client_id: Option<String>,
/// Tenant ID/domain, or `organizations`
#[arg(long, default_value = "organizations", env = "TEAMS_TENANT")]
pub tenant: String,
/// Save configuration without starting sign-in
#[arg(long)]
pub no_login: bool,
/// Use device-code sign-in instead of browser PKCE
#[arg(long)]
pub device_code: bool,
/// Request admin-consented access to read channel history
#[arg(long)]
pub channel_history: bool,
/// Block remote write operations for this profile
#[arg(long, env = "TEAMS_READ_ONLY")]
pub read_only: bool,
}
#[derive(Debug, Subcommand)]
pub enum ConfigCommand {
/// Print the resolved profile without credentials
Show,
/// Print the absolute configuration file path
Path,
}
#[derive(Debug, Subcommand)]
pub enum AuthCommand {
/// Sign in with delegated OAuth
Login {
/// Use device-code sign-in for headless and remote environments
#[arg(long)]
device_code: bool,
/// Request admin-consented access to read channel history
#[arg(long)]
channel_history: bool,
},
/// Remove locally stored credentials
Logout,
/// Show local authentication status without network access
Status,
}
#[derive(Debug, Subcommand)]
pub enum ChannelsCommand {
/// List channels in a team
List {
team: String,
#[command(flatten)]
page: OffsetPageArgs,
},
}
#[derive(Debug, Subcommand)]
pub enum ChatsCommand {
List(PageArgs),
}
#[derive(Debug, Args, Clone)]
pub struct PageArgs {
/// Maximum records in this page
#[arg(long, default_value_t = 50, value_parser = clap::value_parser!(u16).range(1..=50))]
pub limit: u16,
/// Opaque continuation URL from a previous response
#[arg(long)]
pub cursor: Option<String>,
/// Comma-separated output fields
#[arg(long)]
pub fields: Option<String>,
}
#[derive(Debug, Args, Clone)]
pub struct OffsetPageArgs {
/// Maximum records in this page
#[arg(long, default_value_t = 50, value_parser = clap::value_parser!(u16).range(1..=100))]
pub limit: u16,
/// Number of records to skip
#[arg(long, default_value_t = 0)]
pub offset: usize,
/// Comma-separated output fields
#[arg(long)]
pub fields: Option<String>,
}
#[derive(Debug, Subcommand)]
pub enum MessagesCommand {
/// List messages from a chat or channel
List {
#[arg(long, conflicts_with = "team", required_unless_present = "team")]
chat: Option<String>,
#[arg(long, requires = "channel", required_unless_present = "chat")]
team: Option<String>,
#[arg(long, requires = "team")]
channel: Option<String>,
#[command(flatten)]
page: PageArgs,
},
/// Send a message as the signed-in user
Send {
#[arg(long, conflicts_with = "team", required_unless_present = "team")]
chat: Option<String>,
#[arg(long, requires = "channel", required_unless_present = "chat")]
team: Option<String>,
#[arg(long, requires = "team")]
channel: Option<String>,
/// Plain-text message body; use '-' to read stdin
#[arg(long)]
body: String,
},
}
#[derive(Debug, Args)]
pub struct TuiArgs {
/// Use deterministic sample data; no account or network required
#[arg(long)]
pub demo: bool,
/// Print one ANSI-free frame instead of taking over the terminal
#[arg(long, requires = "demo")]
pub snapshot: bool,
#[arg(long, default_value_t = 100, hide = true)]
pub width: u16,
#[arg(long, default_value_t = 30, hide = true)]
pub height: u16,
}