/ 
Langertha-0.202
River stage zero No dependents
/ Langertha::Raider::Result

NAME

Langertha::Raider::Result - Result object from a Raider raid

VERSION

version 0.202

SYNOPSIS

my $result = await $raider->raid_f('What files are here?');

# Stringifies to text (backward compatible)
say $result;

# Check result type
if ($result->is_final) {
    say "Final answer: $result";
} elsif ($result->is_question) {
    say "Agent asks: " . $result->content;
    my $answer = <STDIN>;
    my $continued = await $raider->respond_f($answer);
} elsif ($result->is_pause) {
    say "Agent paused: " . $result->content;
    my $continued = await $raider->respond_f('continue');
} elsif ($result->is_abort) {
    say "Agent aborted: " . $result->content;
}

DESCRIPTION

Wraps the outcome of a "raid_f" in Langertha::Raider call. The type field indicates what happened:

final - The LLM produced a final text answer (in text).
question - The agent used raider_ask_user and needs a response (question in content, optional choices in options).
pause - The agent used raider_pause and is waiting to be resumed (reason in content).
abort - The agent used raider_abort and stopped (reason in content).

Uses overload so stringification returns text, preserving backward compatibility with code that treats raid results as plain strings.

type

Result type: final, question, pause, or abort.

text

The final text answer from the LLM. Only set when type is final.

content

The question, pause reason, or abort reason. Set for non-final result types.

options

Optional list of choices for a question result.

is_final

Returns true if this is a final text answer.

is_question

Returns true if the agent is asking the user a question.

is_pause

Returns true if the agent has paused.

is_abort

Returns true if the agent has aborted.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha/issues.

CONTRIBUTING

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

AUTHOR

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

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.