NAME

App::Raider::Plugin::Trace - Live ANSI-colored progress output for a running Langertha::Raider raid

VERSION

version 0.003

SYNOPSIS

my $raider = Langertha::Raider->new(
    engine  => $engine,
    plugins => ['+App::Raider::Plugin::Trace'],
);

DESCRIPTION

Streaming trace plugin used by App::Raider to show live progress during a raid: per-iteration markers, each tool call with a short argument summary, and the tool result (ok / error / length). Palette is blue-dominant with yellow accents to match the rest of the CLI.

Set ANSI_COLORS_DISABLED=1 or construct with color => 0 to render without ANSI sequences.

color

Whether to emit ANSI colors. Defaults to true when STDOUT is a terminal.

max_value_length

Maximum characters shown per argument value in tool-call summaries. Longer strings are truncated with an ellipsis. Defaults to 80.

token_stats

Running cumulative hashref: { prompt, completion, total, calls }. Updated after every LLM response; read via the token_stats accessor or through "token_stats" in App::Raider.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-app-raider/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.