Struct Response 

pub struct Response<T> {
    pub status: ResponseStatus,
    pub metadata: Option<QueryMetadata>,
    pub data: Option<T>,
    pub error: Option<ErrorDetail>,
    pub warnings: Option<Vec<String>>,
}

Unified response envelope.

All obz commands produce this structure. The status field is always "success" or "error", allowing AI Agents to reliably parse output.

Fields

status: ResponseStatus

Response status: “success” or “error”.

metadata: Option<QueryMetadata>

Query metadata (success responses only).

data: Option<T>

Response data (success responses only).

error: Option<ErrorDetail>

Error detail (error responses only).

warnings: Option<Vec<String>>

Non-fatal warnings from the backend.

Implementations

impl<T: Serialize> Response<T>

pub fn success(metadata: QueryMetadata, data: T) -> Self

Create a success response.

impl<T> Response<T>

pub fn error(error: ErrorDetail) -> Self

Create an error response.

Does not require T: Serialize since data is always None for errors.

Trait Implementations

impl<T: Clone> Clone for Response<T>

fn clone(&self) -> Response<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Response<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Response<T>

where T: DeserializeOwned,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for Response<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.