builtbyberry / laravel-swarm-pulse

v0.1.6 2026-09-04 02:58 UTC

Requires

• php: ^8.4
• builtbyberry/laravel-swarm: ^0.22 || ^0.23 || ^0.24 || ^0.25
• illuminate/console: ^13.0
• illuminate/contracts: ^13.0
• illuminate/filesystem: ^13.0
• illuminate/support: ^13.0
• laravel/pulse: ^1.7
• livewire/livewire: ^3.0 || ^4.1

Requires (Dev)

• builtbyberry/laravel-swarm-installer-testkit: ^0.1.3
• larastan/larastan: ^3.10
• laravel/pint: ^1.29
• orchestra/testbench: ^11.1
• pestphp/pest: ^4.7
• pestphp/pest-plugin-laravel: ^4.1

MIT

• Daniel Berry

• laravel
• agents
• ai
• pulse
• swarm
• observability

Published on Packagist.org on 2026-09-04 10:21 UTC

README

Laravel Pulse integration for Laravel Swarm — recorders and dashboard cards for swarm runs, step durations, memory growth, and audit outbox observability.

This package was extracted from builtbyberry/laravel-swarm core in v0.17.1 to keep the core package's dependency footprint small. If you were using Pulse recorders or cards from laravel-swarm before v0.17.1, install this package and update your imports — see UPGRADING.md in core for the migration steps.

Requirements

• PHP 8.4+
• builtbyberry/laravel-swarm ^0.22 through ^0.25
• Livewire ^3.0 or ^4.1

Installation

composer require builtbyberry/laravel-swarm-pulse

This pulls in laravel/pulse as a dependency. Then publish and migrate Pulse, and run the swarm installer:

php artisan vendor:publish --provider="Laravel\Pulse\PulseServiceProvider"

php artisan migrate

php artisan swarm:install:pulse

swarm:install:pulse registers the SwarmRuns, SwarmStepDurations, and SwarmMemoryMetrics recorders in config/pulse.php and injects the swarm cards into resources/views/vendor/pulse/dashboard.blade.php. Both edits are sentinel-fenced and safe to re-run; the original files are backed up to <file>.bak before the first mutation.

Pick which cards to enable with --cards (default: all four):

php artisan swarm:install:pulse --no-interaction --cards=runs,steps

If Pulse is not installed, the command refuses with a copy-paste hint and exits non-zero.

Cards

Card	Livewire tag	What it shows
Swarm Runs	<livewire:swarm.runs />	Per-swarm totals, failures, failure rate, average run duration, topology mix
Swarm Steps	<livewire:swarm.steps />	Slowest average step durations by swarm + agent
Swarm Audit Outbox	<livewire:swarm.audit-outbox />	Live operational state of the audit outbox (pending, dead-letter, stale)
Swarm Memory	<livewire:swarm.memory />	Memory growth + snapshot size per scope

See core's docs/pulse.md for the full aggregate-type reference, tuning knobs, and troubleshooting guide — this package's behavior is unchanged from the pre-extraction integration, only the namespace and package boundary moved.

License

MIT.