The first PHP framework with an AI orchestration engine built in.

use MonkeysLegion\Apex\AI;
use MonkeysLegion\Apex\Provider\Anthropic\AnthropicProvider;
use MonkeysLegion\Apex\Provider\OpenAI\OpenAIProvider;
use MonkeysLegion\Apex\Provider\Google\GoogleProvider;

// Pick one — the rest of your code doesn't change
$provider = new AnthropicProvider(
    apiKey: $_ENV['ANTHROPIC_API_KEY'],
    model: 'claude-sonnet-4',
);

$ai = new AI($provider);
$response = $ai->generate('Explain PHP 8.4 property hooks');

final class SentimentResult extends Schema
{
    public function __construct(
        #[Description('Detected sentiment')]
        #[Constrain(enum: ['positive', 'negative', 'neutral'])]
        public readonly string $sentiment,

        #[Description('Confidence 0–1')]
        #[Constrain(min: 0.0, max: 1.0)]
        public readonly float $confidence,

        #[Description('Key phrases')]
        #[ArrayOf('string')]
        public readonly array $phrases = [],
    ) {}
}

$result = $ai->extract(SentimentResult::class, 'Amazing!');
echo $result->sentiment;   // 'positive'

use MonkeysLegion\Apex\Tool\Attribute\{Tool, ToolParam};

final class WeatherTools
{
    #[Tool(name: 'get_weather', description: 'Get current weather')]
    public function getWeather(
        #[ToolParam(description: 'City name', required: true)]
        string $city,
        #[ToolParam(enum: ['celsius', 'fahrenheit'])]
        string $unit = 'celsius',
    ): array {
        return ['city' => $city, 'temp' => 22, 'unit' => $unit];
    }
}

$response = $ai->generate(
    "What's the weather in Tokyo?",
    options: ['tools' => [new WeatherTools()]],
);

use MonkeysLegion\Apex\Pipeline\Pipeline;
use MonkeysLegion\Apex\Pipeline\Step\{
    GenerateStep, SummarizeStep, TranslateStep, GuardStep
};

$result = Pipeline::create('research-and-translate')
    ->pipe(new GuardStep($guard, isInput: true))
    ->pipe(new GenerateStep($ai, system: 'Research thoroughly'))
    ->pipe(new SummarizeStep($ai, maxWords: 200))
    ->pipe(new TranslateStep($ai, 'Spanish'))
    ->pipe(new GuardStep($guard, isInput: false))
    ->run('Quantum computing in healthcare');

echo $result->output;        // Final translated result
echo count($result->trace);  // Step-by-step trace

use MonkeysLegion\Apex\Agent\{Agent, Crew};
use MonkeysLegion\Apex\Enum\AgentProcess;

$crew = new Crew('content-team', [
    new Agent('researcher', 'Research with academic rigor.', $ai),
    new Agent('writer', 'Write engaging, clear content.', $ai),
    new Agent('editor', 'Edit for grammar and tone.', $ai),
], AgentProcess::Sequential);

$results = $crew->run('Blog post on PHP 8.4 property hooks');
// researcher → writer → editor → final output

$pipeline = GuardPipeline::create()
    ->add(new PromptInjectionValidator(), GuardAction::Block)
    ->add(new PIIDetectorValidator(),     GuardAction::Redact)
    ->add(new ToxicityValidator(),        GuardAction::Warn)
    ->add(new WordCountValidator(max: 500), GuardAction::Truncate);

$result = $pipeline->run($text);

$pipeline = (new MiddlewarePipeline())
    ->push(new RateLimitMiddleware(maxRequests: 60))
    ->push(new RetryMiddleware(maxRetries: 3))
    ->push(new CacheMiddleware($cache, ttl: 3600))
    ->push(new InputGuardMiddleware($guard))
    ->push(new OutputGuardMiddleware($guard))
    ->push(new CostBudgetMiddleware($tracker, maxBudget: 100.0))
    ->push(new TelemetryMiddleware($logger))
    ->push(new FallbackMiddleware($backupProvider));