builtbyberry/laravel-swarm-pulse

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

v0.1.1 2026-07-06 10:20 UTC

Requires

• php: ^8.5
• builtbyberry/laravel-swarm: ^0.17
• illuminate/console: ^13.0
• illuminate/contracts: ^13.0
• illuminate/filesystem: ^13.0
• illuminate/support: ^13.0
• laravel/pulse: ^1.7
• livewire/livewire: ^3.0

Requires (Dev)

• 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-07-06 10:22 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.

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.