laravel-gezel maintained by onomahq
Description
Shared Laravel package for Gezel apps: per-user agent containers via the middleware gateway
Author
Last update
2026/07/19 17:28
(dev-main)
License
Downloads
24
Tags
laravel-gezel
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 +
HasGezelAgenttrait on a configurable owner model (defaultUser) - 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
GezelMcpServeronlaravel/mcp+TurnContextProviderseam
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.