grok-build-upstream-mirror/crates/codegen/xai-grok-pager/src/slash/commands/queue.rs

//! `/queue` -- list the queued prompts as a committed system block.
//!
//! Minimal mode has no interactive `QueuePane`, so `/queue` is the way to
//! inspect what's waiting behind the running turn. It works in every
//! render mode. The dispatcher (`dispatch_show_queue`) reads the merged
//! server + local queue and commits a read-only list; editing the queue is
//! out of scope here (use the queue pane in the full TUI).

use crate::app::actions::Action;
use crate::slash::command::{CommandExecCtx, CommandResult, SlashCommand};

/// List the queued prompts.
pub struct QueueCommand;

impl SlashCommand for QueueCommand {
    fn name(&self) -> &str {
        "queue"
    }

    fn description(&self) -> &str {
        "List the prompts queued behind the running turn"
    }

    fn session_scoped(&self) -> bool {
        true
    }

    fn usage(&self) -> &str {
        "/queue"
    }

    fn run(&self, ctx: &mut CommandExecCtx, _args: &str) -> CommandResult {
        if ctx.session_id.is_none() {
            return CommandResult::Error("No active session".to_string());
        }
        CommandResult::Action(Action::ShowQueue)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::acp::model_state::ModelState;
    use crate::app::bundle::BundleState;
    use crate::settings::PagerLocalSnapshot;

    static DEFAULT_BUNDLE_STATE: BundleState = BundleState {
        has_cache: false,
        version: String::new(),
        personas: Vec::new(),
        roles: Vec::new(),
        agents: Vec::new(),
        skills: Vec::new(),
        persona_details: Vec::new(),
        role_details: Vec::new(),
    };

    fn ctx_with_session(models: &ModelState, sid: Option<&agent_client_protocol::SessionId>) {
        let mut ctx = CommandExecCtx {
            models,
            session_id: sid,
            bundle_state: &DEFAULT_BUNDLE_STATE,
            screen_mode: crate::app::ScreenMode::Minimal,
            billing_surface_visible: true,
            pager_state: PagerLocalSnapshot::default(),
        };
        match (QueueCommand.run(&mut ctx, ""), sid.is_some()) {
            (CommandResult::Action(Action::ShowQueue), true) => {}
            (CommandResult::Error(msg), false) => assert!(msg.contains("No active session")),
            (other, has) => panic!("unexpected result {other:?} for has_session={has}"),
        }
    }

    #[test]
    fn no_session_errors() {
        let models = ModelState::default();
        ctx_with_session(&models, None);
    }

    #[test]
    fn with_session_dispatches_show_queue() {
        let models = ModelState::default();
        let sid = agent_client_protocol::SessionId::from("s1".to_string());
        ctx_with_session(&models, Some(&sid));
    }

    #[test]
    fn available_in_minimal_by_default() {
        assert!(QueueCommand.available_in_minimal());
    }
}