Struct Output 

pub struct Output { /* private fields */ }

Result type that handles output formatting and exit codes.

Builds Agent-First Data-compliant JSON (code/result/trace/error), redacts secrets, formats via agent_first_data, and prints protocol/log events to stdout.

Implementations

impl Output

pub fn new(format: OutputFormat) -> Self

pub fn value(&self, value: Value) -> ExitCode

Emit a pre-built AFDATA value whose top-level code is already set.

pub fn ok<T: Serialize>(&self, result: T) -> ExitCode

{code: “ok”, result: …} → stdout

pub fn ok_trace<T: Serialize>( &self, result: T, trace: impl Serialize, ) -> ExitCode

{code: “ok”, result: …, trace: …} → stdout

pub fn error(&self, error_code: &str, message: &str) -> ExitCode

{code: “<error_code>”, error: “msg”, hint: “…”, trace: {duration_ms: 0}} → stdout

pub fn error_hint( &self, error_code: &str, message: &str, hint: Option<&str>, ) -> ExitCode

Like [error] but with an actionable hint for remediation.

pub fn error_from(&self, error_code: &str, err: &Error) -> ExitCode

Output error from anyhow::Error

pub fn error_hypha(&self, err: &HyphaError) -> ExitCode

Output error from crate::HyphaError (includes hint when present).

pub fn progress(&self, step: u32, total: u32, message: &str, data: Value)

Agent-First Data progress step → stdout {“code”: “progress”, “current”: N, “total”: M, “message”: “…”, …}

pub fn download_progress(&self, downloaded_bytes: u64, total_bytes: Option<u64>)

Byte-level download progress → stdout {“code”: “download_progress”, “downloaded_bytes”: N, “total_bytes”: M}

pub fn warn(&self, code: &str, message: &str)

Non-fatal warning → stdout

pub fn startup(&self, args: Value)

{code: “log”, event: “startup”, args: …, config: …, env: …} → stdout