Struct AppServer 

pub struct AppServer { /* private fields */ }

Thin, explicit JSON-RPC facade for codex app-server.

• request_json / notify_json: validated raw calls.
• request_typed / notify_typed: generated protocol-spec bridges backed by codexus::protocol.
• *_unchecked: bypass contract checks for experimental/custom methods.
• server request loop is exposed directly for approval/user-input workflows.

Method-specific convenience wrappers are intentionally excluded from this surface.

Implementations

impl AppServer

pub async fn connect(config: ClientConfig) -> Result<Self, ClientError>

Connect app-server with explicit config.

pub async fn connect_default() -> Result<Self, ClientError>

Connect app-server with default runtime discovery.

pub async fn request_json( &self, method: &str, params: Value, ) -> Result<Value, RpcError>

Validated JSON-RPC request for known methods.

pub async fn request_json_with_mode( &self, method: &str, params: Value, mode: RpcValidationMode, ) -> Result<Value, RpcError>

JSON-RPC request with explicit validation mode.

pub async fn request_typed<M>( &self, params: impl Into<M::Params>, ) -> Result<M::Response, RpcError>

where M: ClientRequestSpec,

Typed JSON-RPC request backed by a generated protocol spec.

pub async fn request_typed_with_mode<M>( &self, params: impl Into<M::Params>, mode: RpcValidationMode, ) -> Result<M::Response, RpcError>

where M: ClientRequestSpec,

Typed JSON-RPC request backed by a generated protocol spec with explicit validation mode.

pub async fn request_json_unchecked( &self, method: &str, params: Value, ) -> Result<Value, RpcError>

Unchecked JSON-RPC request. Use for experimental/custom methods where strict contracts are not fixed yet.

pub async fn notify_json( &self, method: &str, params: Value, ) -> Result<(), RuntimeError>

Validated JSON-RPC notification for known methods.

pub async fn notify_json_with_mode( &self, method: &str, params: Value, mode: RpcValidationMode, ) -> Result<(), RuntimeError>

JSON-RPC notification with explicit validation mode.

pub async fn notify_typed<N>( &self, params: impl Into<N::Params>, ) -> Result<(), RuntimeError>

where N: ClientNotificationSpec,

Typed JSON-RPC notification backed by a generated protocol spec.

pub async fn notify_typed_with_mode<N>( &self, params: impl Into<N::Params>, mode: RpcValidationMode, ) -> Result<(), RuntimeError>

where N: ClientNotificationSpec,

Typed JSON-RPC notification backed by a generated protocol spec with explicit validation mode.

pub async fn notify_json_unchecked( &self, method: &str, params: Value, ) -> Result<(), RuntimeError>

Unchecked JSON-RPC notification.

pub async fn take_server_requests( &self, ) -> Result<ServerRequestRx, RuntimeError>

Take exclusive server-request stream receiver.

This enables explicit handling of approval / requestUserInput / tool-call cycles.

pub async fn respond_server_request_ok( &self, approval_id: &str, result: Value, ) -> Result<(), RuntimeError>

Reply success payload for one server request.

pub async fn respond_server_request_err( &self, approval_id: &str, err: RpcErrorObject, ) -> Result<(), RuntimeError>

Reply error payload for one server request.

pub fn runtime(&self) -> &Runtime

Borrow server runtime for full low-level control.

pub fn client(&self) -> &Client

Borrow underlying connected client.

pub async fn shutdown(&self) -> Result<(), RuntimeError>

Explicit shutdown.

Trait Implementations

impl Clone for AppServer

fn clone(&self) -> AppServer

Returns a duplicate of the value.

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

Performs copy-assignment from source.