feat: gateway to chat to goose - telegram etc (#7199)

crates/goose-cli/src/cli.rs

@@ -592,6 +592,37 @@ enum SchedulerCommand {
     CronHelp {},
 }
 
+#[derive(Subcommand)]
+enum GatewayCommand {
+    #[command(about = "Show gateway status")]
+    Status {},
+
+    #[command(about = "Start a gateway")]
+    Start {
+        #[arg(help = "Gateway type (e.g., 'telegram')")]
+        gateway_type: String,
+
+        #[arg(
+            long = "bot-token",
+            help = "Bot token for the gateway platform",
+            long_help = "Authentication token for the gateway platform (e.g., Telegram bot token)"
+        )]
+        bot_token: String,
+    },
+
+    #[command(about = "Stop a running gateway")]
+    Stop {
+        #[arg(help = "Gateway type to stop (e.g., 'telegram')")]
+        gateway_type: String,
+    },
+
+    #[command(about = "Generate a pairing code for a gateway")]
+    Pair {
+        #[arg(help = "Gateway type to generate pairing code for")]
+        gateway_type: String,
+    },
+}
+
 #[derive(Subcommand)]
 enum RecipeCommand {
     /// Validate a recipe file
@@ -785,6 +816,16 @@ enum Command {
         command: SchedulerCommand,
     },
 
+    /// Manage gateways for external platform integrations (e.g., Telegram)
+    #[command(
+        about = "Manage gateways for external platform integrations",
+        visible_alias = "gw"
+    )]
+    Gateway {
+        #[command(subcommand)]
+        command: GatewayCommand,
+    },
+
     /// Update the goose CLI version
     #[command(about = "Update the goose CLI version")]
     Update {
@@ -998,6 +1039,7 @@ fn get_command_name(command: &Option<Command>) -> &'static str {
         Some(Command::Project {}) => "project",
         Some(Command::Projects) => "projects",
         Some(Command::Run { .. }) => "run",
+        Some(Command::Gateway { .. }) => "gateway",
         Some(Command::Schedule { .. }) => "schedule",
         Some(Command::Update { .. }) => "update",
         Some(Command::Recipe { .. }) => "recipe",
@@ -1390,6 +1432,23 @@ async fn handle_run_command(
     }
 }
 
+async fn handle_gateway_command(command: GatewayCommand) -> Result<()> {
+    use crate::commands::gateway;
+
+    match command {
+        GatewayCommand::Status {} => gateway::handle_gateway_status().await,
+        GatewayCommand::Start {
+            gateway_type,
+            bot_token,
+        } => {
+            let platform_config = serde_json::json!({ "bot_token": bot_token });
+            gateway::handle_gateway_start(gateway_type, platform_config).await
+        }
+        GatewayCommand::Stop { gateway_type } => gateway::handle_gateway_stop(gateway_type).await,
+        GatewayCommand::Pair { gateway_type } => gateway::handle_gateway_pair(gateway_type).await,
+    }
+}
+
 async fn handle_schedule_command(command: SchedulerCommand) -> Result<()> {
     match command {
         SchedulerCommand::Add {
@@ -1714,6 +1773,7 @@ pub async fn cli() -> anyhow::Result<()> {
             )
             .await
         }
+        Some(Command::Gateway { command }) => handle_gateway_command(command).await,
         Some(Command::Schedule { command }) => handle_schedule_command(command).await,
         Some(Command::Update {
             canary,