laravel-agent-native

Inspired by the Agent-Native architecture pioneered by Builder.io, brought natively to the Laravel & Livewire ecosystem.

Define an action once — a plain PHP method with an attribute. Your Livewire UI calls it, and LLM agents get it as a standards-compliant tool. No duplicated schemas, no manual tool registries.

#[AgentAction(description: 'Add a product to the shopping cart')]
public function addItem(int $productId, int $quantity = 1): void
{
    $this->items[] = compact('productId', 'quantity');
}

→ auto-compiled to OpenAI/MCP tool JSON, validated and executed through the container, with Livewire state/events in sync.

Install

composer require nataondev/laravel-agent-native
php artisan vendor:publish --tag=agent-native-config

• PHP 8.2+ · Laravel 11+ · Livewire 3+ or 4+ (optional)

How it works

1. Annotate — #[AgentAction] on any public method (service or Livewire component).
2. Compile — reflection builds the tool schema from native types, enums, and docblocks.
3. Execute — ActionExecutor validates arguments, resolves the class via the container, invokes, and returns a structured ActionResult.
4. React — AgentBridge notifies your app (and listening components) that the agent acted.

Documentation

Quick example

php artisan agent:inspect --json   # tool schemas, ready for your LLM

use AgentNative\Laravel\Engine\ActionExecutor;

$result = app(ActionExecutor::class)->call('addItem', ['productId' => 42]);

$result->ok;     // true
$result->output; // JSON-safe return value

Testing

composer test   # Pest — 35 tests
composer lint   # Pint

License

MIT