Struct ClientConfig 

pub struct ClientConfig {
    pub cli_bin: PathBuf,
    pub compatibility_guard: CompatibilityGuard,
    pub initialize_capabilities: InitializeCapabilities,
    pub hooks: RuntimeHookConfig,
}

Fields

cli_bin: PathBuf

compatibility_guard: CompatibilityGuard

initialize_capabilities: InitializeCapabilities

hooks: RuntimeHookConfig

Implementations

impl ClientConfig

pub fn new() -> Self

Create config with default binary discovery.

pub fn with_cli_bin(self, cli_bin: impl Into<PathBuf>) -> Self

Override CLI executable path.

pub fn with_compatibility_guard(self, guard: CompatibilityGuard) -> Self

Override runtime compatibility guard policy.

pub fn without_compatibility_guard(self) -> Self

Disable compatibility guard checks at connect time.

pub fn with_initialize_capabilities( self, initialize_capabilities: InitializeCapabilities, ) -> Self

Override initialize capability switches.

pub fn enable_experimental_api(self) -> Self

Opt into Codex experimental app-server methods and fields.

pub fn with_hooks(self, hooks: RuntimeHookConfig) -> Self

Replace runtime hook configuration.

pub fn with_pre_hook(self, hook: Arc<dyn PreHook>) -> Self

Register one pre hook on client runtime config.

pub fn with_post_hook(self, hook: Arc<dyn PostHook>) -> Self

Register one post hook on client runtime config.

pub fn with_pre_tool_use_hook(self, hook: Arc<dyn PreHook>) -> Self

Register one pre-tool-use hook on client runtime config. When at least one pre-tool-use hook is registered, the runtime manages the approval channel internally and auto-escalates ApprovalPolicy → Untrusted. Allocation: amortized O(1) push. Complexity: O(1).

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ClientConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for ClientConfig

fn eq(&self, other: &ClientConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ClientConfig

impl StructuralPartialEq for ClientConfig