Crate ralph_proto 

ralph-proto

Shared types, error definitions, and traits for the Ralph Orchestrator framework.

This crate provides the foundational abstractions used across all Ralph crates, including:

• Event and EventBus types for pub/sub messaging
• Hat definitions for agent personas
• Topic matching for event routing
• Common error types

Re-exports

pub use daemon::DaemonAdapter;

pub use daemon::StartLoopFn;

pub use json_rpc::GuidanceTarget;

pub use json_rpc::RpcCommand;

pub use json_rpc::RpcEvent;

pub use json_rpc::RpcIterationInfo;

pub use json_rpc::RpcState;

pub use json_rpc::RpcTaskCounts;

pub use json_rpc::RpcTaskSummary;

pub use json_rpc::TerminationReason;

pub use json_rpc::emit_event;

pub use json_rpc::emit_event_line;

pub use json_rpc::parse_command;

pub use robot::CheckinContext;

pub use robot::RobotService;

Modules

daemon

Daemon mode abstractions.

json_rpc

JSON-RPC protocol types for Ralph’s stdin/stdout communication.

robot

Human-in-the-loop robot service abstractions.

Structs

Event

An event in the pub/sub system.

EventBus

Central pub/sub hub for routing events between hats.

Hat

A hat (persona) that defines agent behavior.

HatId

Unique identifier for a hat.

TerminalColorMode

Color mode detection result.

TerminalResize

Terminal dimension change event.

TerminalWrite

Raw bytes written to stdout or stderr.

Topic

A topic for event routing.

TuiFrame

TUI frame capture for future ralph-tui integration.

Enums

Error

Errors that can occur in the Ralph Orchestrator.

UxEvent

A UX event captured during session recording.

Traits

FrameCapture

Abstract interface for capturing rendered output.

Type Aliases

Result

Result type alias using our Error type.