Enum RecordError 

pub enum RecordError {
    Spawn {
        command: String,
        reason: String,
    },
    Pty(String),
    Store(Error),
    Child(String),
    Adapter(String),
    Mcp(String),
    McpSession(String),
}

A specialization of hh_core::Error for recorder-originated failures, keeping the cause chain readable for the binary’s anyhow context.

portable-pty returns anyhow::Error; we stringify it at the boundary (its Display form) rather than taking an anyhow dependency in this library, per CLAUDE.md (“Do not add a dependency without stating why”).

Variants

Spawn

Failed to spawn the child in the PTY (FR-1.1).

Fields

command: String

The command line that failed.

reason: String

The stringified portable-pty error.

Pty(String)

A PTY I/O or configuration error (resize, reader/writer, wait).

Store(Error)

A storage call failed while recording (session create, event append, blob put, finalize). Wraps the hh-core error so the binary can attach anyhow::Context.

Child(String)

The child could not be waited on, or its exit status was unreadable.

Adapter(String)

An unknown or unsupported adapter name was passed to hh run --adapter (FR-1.5). Names the bad value and what’s available so the user can fix it.

Mcp(String)

A generic MCP proxy failure (server spawn, stdio I/O, store). The string is a human-readable, actionable description (FR-2).

McpSession(String)

The HH_SESSION_ID referenced by an attached hh mcp-proxy does not resolve to a recorded session (FR-2). Actionable: tells the user to run standalone or re-run inside hh run rather than creating an orphan.

Trait Implementations

impl Debug for RecordError

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

Formats the value using the given formatter.

impl Display for RecordError

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

Formats the value using the given formatter.

impl Error for RecordError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for RecordError

fn from(source: Error) -> Self

Converts to this type from the input type.