/ 
Langertha-Raider-0.503
/ Langertha::Raider::Plugin::Trace

NAME

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

VERSION

version 0.503

SYNOPSIS

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

DESCRIPTION

Streaming trace plugin used by Langertha::Raider::CLI 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.

A "thinking..." spinner runs while a model request is in flight when a "loop" is given, colors are on and "out" is a terminal.

color

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

out

Filehandle the trace is printed to. Defaults to STDOUT; the raider CLI passes STDERR when stdout carries machine output.

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 Langertha::Raider::CLI.

loop

Optional IO::Async::Loop used to drive a small "thinking…" spinner while the LLM HTTP call is in flight. When absent, no spinner is shown.

ENVIRONMENT

ANSI_COLORS_DISABLED

Set, the trace has no colors and no spinner, whatever "color" says.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha-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.