Struct AppServer 

pub struct AppServer { /* private fields */ }

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

• request_json / notify_json: validated calls for known methods.
• request_typed / notify_typed: typed wrappers with contract validation.
• *_unchecked: bypass contract checks for experimental/custom methods.
• server request loop is exposed directly for approval/user-input workflows.

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<P, R>( &self, method: &str, params: P, ) -> Result<R, RpcError>

where P: Serialize, R: DeserializeOwned,

Typed JSON-RPC request for known methods.

pub async fn request_typed_with_mode<P, R>( &self, method: &str, params: P, mode: RpcValidationMode, ) -> Result<R, RpcError>

where P: Serialize, R: DeserializeOwned,

Typed JSON-RPC request 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 skills_list( &self, params: SkillsListParams, ) -> Result<SkillsListResponse, RpcError>

Typed helper for skills/list.

pub async fn command_exec( &self, params: CommandExecParams, ) -> Result<CommandExecResponse, RpcError>

Typed helper for command/exec.

pub async fn command_exec_write( &self, params: CommandExecWriteParams, ) -> Result<CommandExecWriteResponse, RpcError>

Typed helper for command/exec/write.

pub async fn command_exec_resize( &self, params: CommandExecResizeParams, ) -> Result<CommandExecResizeResponse, RpcError>

Typed helper for command/exec/resize.

pub async fn command_exec_terminate( &self, params: CommandExecTerminateParams, ) -> Result<CommandExecTerminateResponse, RpcError>

Typed helper for command/exec/terminate.

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<P>( &self, method: &str, params: P, ) -> Result<(), RuntimeError>

where P: Serialize,

Typed JSON-RPC notification for known methods.

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

where P: Serialize,

Typed JSON-RPC notification 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.