onomahq/laravel-gezel

Shared Laravel package for Gezel apps: per-user agent containers via the middleware gateway

v0.2.0 2026-07-21 12:24 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^11.0||^12.0||^13.0
• laravel/mcp: ^0.8
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/passport: ^13.7.5
• laravel/pint: ^1.14
• laravel/sanctum: ^4.0
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^11.0.0||^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0

Suggests

• laravel/passport: Required to use the 'passport' gezel.auth.driver (Stagent-compatible, user-bound owners only).
• laravel/sanctum: Required to use the 'sanctum' gezel.auth.driver (default; works on any HasApiTokens owner).

MIT

• Mischa Sigtermans

• laravel
• Onoma
• laravel-gezel

Published on Packagist.org on 2026-07-21 12:24 UTC

README

Shared Laravel package for apps built on Gezel, the per-user agent runtime behind the middleware gateway. Used by Onoma Platform, Stagent and Calmunity.

Spec: research/26-07-16-laravel-gezel-package.md in onomahq/onoma.

What it ships

• config/gezel.php — one canonical config (middleware URL, app token, service token)
• Migration stub + HasGezelAgent trait on a configurable owner model (default User)
• Clients: GezelOrchestrator (container lifecycle), GezelClient (per-owner proxy), GezelStreamClient (SSE chat)
• Inbound callback routes: agent-messages, principals/verify, turn-context — service-token guarded
• Pluggable auth seams: ContainerBearerIssuer, PrincipalVerifier (Sanctum and Passport drivers)
• Provisioning job + artisan commands (gezel:provision-missing, gezel:reconcile-container-bearers, gezel:health)
• Abstract GezelMcpServer on laravel/mcp + TurnContextProvider seam

Installation

composer require onomahq/laravel-gezel
php artisan vendor:publish --tag="laravel-gezel-config"
php artisan vendor:publish --tag="laravel-gezel-migrations"
php artisan migrate

Testing

composer test

Status

Scaffold. Built in reviewable PRs per module; review by Lennert and Mischa.

License

The MIT License (MIT). Please see License File for more information.