Struct AcpContext 

pub struct AcpContext {
    pub file_executor: Option<AcpFileExecutor>,
    pub shell_executor: Option<AcpShellExecutor>,
    pub permission_gate: Option<AcpPermissionGate>,
    pub cancel_signal: Arc<Notify>,
    pub provider_override: Arc<RwLock<Option<AnyProvider>>>,
    pub parent_tool_use_id: Option<String>,
    pub lsp_provider: Option<AcpLspProvider>,
    pub diagnostics_cache: Arc<RwLock<DiagnosticsCache>>,
}

IDE-proxied capabilities passed to the agent loop per session.

Each field is None when the IDE did not advertise the corresponding capability during the ACP initialize() handshake. The agent loop should degrade gracefully when optional capabilities are absent.

Fields

file_executor: Option<AcpFileExecutor>

IDE-proxied filesystem executor (fs.readTextFile / fs.writeTextFile).

None when the IDE did not advertise filesystem capability.

shell_executor: Option<AcpShellExecutor>

IDE-proxied shell executor (terminal.create / terminal.execute).

None when the IDE did not advertise terminal capability.

permission_gate: Option<AcpPermissionGate>

Permission gate for tool-call approval requests sent to the IDE.

None when the IDE did not advertise permission capability.

cancel_signal: Arc<Notify>

Shared cancellation signal.

Notify this to interrupt the currently running agent operation (e.g. on user cancel).

provider_override: Arc<RwLock<Option<AnyProvider>>>

Shared slot for runtime model switching via set_session_config_option.

When Some, the agent should swap its provider before the next turn.

parent_tool_use_id: Option<String>

Tool call ID of the parent agent’s tool call that spawned this subagent session.

None for top-level (non-subagent) sessions.

lsp_provider: Option<AcpLspProvider>

LSP provider when the IDE advertised meta["lsp"] capability.

None when the IDE does not support LSP extension methods.

diagnostics_cache: Arc<RwLock<DiagnosticsCache>>

Shared diagnostics cache — written by the LSP notification handler in ZephAcpAgent and read by the agent loop context builder to inject diagnostics into the system prompt.