Looking to hire Laravel developers? Try LaraJobs

laravel-gezel maintained by onomahq

Description
Shared Laravel package for Gezel apps: per-user agent containers via the middleware gateway
Last update
2026/07/19 17:28 (dev-main)
License
Downloads
24

Comments
comments powered by Disqus

laravel-gezel

GitHub Tests Action Status GitHub Code Style Action Status

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.