NAME

Sim::AgentSoar - SOAR-inspired explicit search with a pluggable LLM worker

SYNOPSIS

use Sim::AgentSoar;
use Sim::AgentSoar::AgentSoar;
use Sim::AgentSoar::Worker;

my $worker = Sim::AgentSoar::Worker->new(model => 'llama3.2:1b');

my $search = Sim::AgentSoar::AgentSoar->new(
    worker               => $worker,
    branching_factor     => 2,
    regression_tolerance => 2,
    max_depth            => 20,
);

my $path = $search->run(start => 4, target => 19);

DESCRIPTION

This distribution implements a deterministic, inspectable best-first search controller (Sim::AgentSoar::AgentSoar) plus a deterministic environment (Sim::AgentSoar::Engine) and an optional LLM-backed operator proposer (Sim::AgentSoar::Worker).

AUTHOR

Gian Luca Brunetti (2026), gianluca.brunetti\@gmail.com

LICENSE

GPLv3.