Reporting

​

askui.reporting.CompositeReporter

class CompositeReporter(Reporter)

A reporter that combines multiple reporters.

Allows generating different reports simultaneously. Each message added will be forwarded to all reporters passed to the constructor. The reporters are called (add_message(), generate()) in the order they are ordered in the reporters list.

Arguments:

• reporters list[Reporter] | None, optional - List of reporters to combine

​

add_message

def add_message(
    role: str,
    content: Union[str, dict[str, Any], list[Any]],
    image: Optional[Image.Image | list[Image.Image]] = None
) -> None

Add a message to the report.

​

generate

def generate() -> None

Generates the final report.

​

askui.reporting.Reporter

class Reporter(ABC)

Abstract base class for reporters. Cannot be instantiated directly.

Defines the interface that all reporters must implement to be used with askui.VisionAgent.

​

add_message

def add_message(
    role: str,
    content: Union[str, dict[str, Any], list[Any]],
    image: Optional[Image.Image | list[Image.Image]] = None
) -> None

Add a message to the report.

Arguments:

• role str - The role of the message sender (e.g., "User", "Assistant", "System")
• content str | dict | list - The message content, which can be a string, dictionary, or list, e.g. 'click 2x times on text "Edit"'
• image PIL.Image.Image | list[PIL.Image.Image], optional - PIL Image or list of PIL Images to include with the message

​

generate

def generate() -> None

Generates the final report.

Implementing this method is only required if the report is not generated in “real-time”, e.g., on calls of add_message(), but must be generated at the end of the execution.

This method is called when the askui.VisionAgent context is exited or askui.VisionAgent.close() is called.

​

askui.reporting.SimpleHtmlReporter

class SimpleHtmlReporter(Reporter)

A reporter that generates HTML reports with conversation logs and system information.

Arguments:

• report_dir str, optional - Directory where reports will be saved. Defaults to reports.

​

add_message

def add_message(
    role: str,
    content: Union[str, dict[str, Any], list[Any]],
    image: Optional[Image.Image | list[Image.Image]] = None
) -> None

Add a message to the report.

​

generate

def generate() -> None

Generate an HTML report file.

Creates a timestamped HTML file in the report_dir containing:

• System information
• All collected messages with their content and images
• Syntax-highlighted JSON content