Struct AcpShellExecutor 

pub struct AcpShellExecutor { /* private fields */ }

IDE-proxied shell executor.

Routes bash tool calls to the IDE terminal via ACP terminal/* methods. Only constructed when the IDE advertises terminal capability.

Implementations

impl AcpShellExecutor

pub fn new( conn: Arc<ConnectionTo<Client>>, session_id: SessionId, permission_gate: Option<AcpPermissionGate>, timeout_secs: u64, ) -> (Self, impl Future<Output = ()>)

Create the executor and its background handler future.

Spawn the returned future with tokio::spawn; it drives terminal create/execute/release requests forwarded from the bash and bash_stdin tools.

pub fn with_timeout( conn: Arc<ConnectionTo<Client>>, session_id: SessionId, permission_gate: Option<AcpPermissionGate>, timeout: Duration, ) -> (Self, impl Future<Output = ()>)

Create the executor with a configurable command timeout.

pub fn release_terminal(&self, terminal_id: String)

Release a terminal by ID after the tool_call_update notification has been sent.

This must be called after the ACP tool_call_update containing ToolCallContent::Terminal(terminal_id) is emitted so that the IDE can still display the terminal output when it processes the notification.

Trait Implementations

impl Clone for AcpShellExecutor

fn clone(&self) -> AcpShellExecutor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ToolExecutor for AcpShellExecutor

async fn execute( &self, _response: &str, ) -> Result<Option<ToolOutput>, ToolError>

Parse response for fenced tool blocks and execute them.

fn tool_definitions(&self) -> Vec<ToolDef>

Return the tool definitions this executor can handle.

async fn execute_tool_call( &self, call: &ToolCall, ) -> Result<Option<ToolOutput>, ToolError>

Execute a structured tool call. Returns Ok(None) if call.tool_id is not handled.

fn requires_confirmation(&self, _call: &ToolCall) -> bool

Return true when call would require user confirmation before execution.

fn execute_tool_call_confirmed( &self, call: &ToolCall, ) -> impl Future<Output = Result<Option<ToolOutput>, ToolError>> + Send

Execute a structured tool call bypassing confirmation checks.

fn checkpoint_undo(&self, _n: usize) -> CheckpointActionResult

Undo the last n checkpointed write commands.

fn checkpoint_redo(&self) -> CheckpointActionResult

Redo the last undone checkpoint.

fn checkpoint_list(&self) -> CheckpointListResult

List the current undo stack entries and redo depth.

fn is_tool_speculatable(&self, _tool_id: &str) -> bool

Whether a tool call can be safely dispatched speculatively (before the LLM finishes).

fn execute_confirmed( &self, response: &str, ) -> impl Future<Output = Result<Option<ToolOutput>, ToolError>> + Send

Execute bypassing confirmation checks (called after user approves).

fn set_skill_env(&self, _env: Option<HashMap<String, String>>)

Inject environment variables for the currently active skill. No-op by default.

fn set_effective_trust(&self, _level: SkillTrustLevel)

Set the effective trust level for the currently active skill. No-op by default.

fn is_tool_retryable(&self, _tool_id: &str) -> bool

Whether the executor can safely retry this tool call on a transient error.