​
marvin.handlers.print_handler

A simplified print handler for rendering streaming events from the engine.

​
Constants

​
RUNNING_SPINNER

RUNNING_SPINNER = Spinner('dots')

​
Classes

​
EventPanel

class EventPanel(id: str, agent_name: str, timestamp: str)
Base class for panels that represent events. Methods:
  • render 
    def render(self) -> Panel
    Render this event as a panel.

​
MessagePanel

class MessagePanel(id: str, agent_name: str, timestamp: str, content: str = '')
Panel for displaying agent messages with streaming updates. Methods:
  • render 
    def render(self) -> Panel
    Render the message as a markdown panel.

​
PrintHandler

class PrintHandler(hide_end_turn_tools: bool | None = None)
A handler that renders events with streaming updates. Methods:
  • format_timestamp 
    def format_timestamp(self, ts) -> str
    Format timestamp for display.
  • on_actor_message 
    def on_actor_message(self, event: ActorMessageEvent)
    Handle complete agent messages.
  • on_actor_message_delta 
    def on_actor_message_delta(self, event: ActorMessageDeltaEvent)
    Handle streaming updates to agent messages.
  • on_end_turn_tool_call 
    def on_end_turn_tool_call(self, event: EndTurnToolCallEvent)
    Handle end turn tool call events.
  • on_end_turn_tool_result 
    def on_end_turn_tool_result(self, event: EndTurnToolResultEvent)
  • on_orchestrator_end 
    def on_orchestrator_end(self, event: OrchestratorEndEvent)
    Clean up when orchestrator ends.
  • on_orchestrator_start 
    def on_orchestrator_start(self, event: OrchestratorStartEvent)
    Start the live display when orchestrator starts.
  • on_tool_call 
    def on_tool_call(self, event: ToolCallEvent)
    Handle complete tool calls.
  • on_tool_call_delta 
    def on_tool_call_delta(self, event: ToolCallDeltaEvent)
    Handle streaming updates to tool calls.
  • on_tool_result 
    def on_tool_result(self, event: ToolResultEvent)
    Handle tool result events.
  • on_tool_retry 
    def on_tool_retry(self, event: ToolRetryEvent)
    Handle tool retry events.
  • update_display 
    def update_display(self)
    Update the terminal display with current panels.

​
ToolCallPanel

class ToolCallPanel(id: str, agent_name: str, timestamp: str, tool_name: str = '', args: Dict[str, Any] = dict(), is_complete: bool = False, result: str = '', is_error: bool = False, is_end_turn_tool: bool = False, tool: EndTurn | Callable[..., Any] | None = None)
Panel for displaying tool calls with streaming updates. Methods:
  • get_status_style 
    def get_status_style(self) -> Tuple[Any, str, str]
    Returns (icon, text style, border style) for current status.
  • render 
    def render(self) -> Panel
    Render the tool call as a panel.
Parent Module: handlers