Files
paseo/plugin-examples/lifecycle-logger
paseo-bot[bot]andilteoood 5375f43a05 feat(plugins): expose agent closed lifecycle event (#5971)
* feat(plugins): expose agent closed lifecycle event

Emit the event when a live agent reaches its closed state so plugins can release agent-scoped resources. Keep archive and close notifications distinct.

Co-authored-by: ilteoood <6383527+ilteoood@users.noreply.github.com>

* fix(plugins): finish close hooks during daemon shutdown

Wait briefly for pending lifecycle events before stopping plugins so agent close hooks can release their resources during shutdown.

Co-authored-by: ilteoood <6383527+ilteoood@users.noreply.github.com>

---------

Co-authored-by: paseo-bot[bot] <266920839+paseo-bot[bot]@users.noreply.github.com>
Co-authored-by: ilteoood <6383527+ilteoood@users.noreply.github.com>
2026-10-03 11:36:19 +01:00
..

Lifecycle logger

Registers all eleven server lifecycle hooks and logs their data as JSON. It observes agent creation, session opening, turns, permissions, archive, and workspace creation/archive. Before hooks return the request unchanged. Environment values are redacted; prompts and timeline content are logged.

Install it on a daemon where plugins are enabled:

paseo plugin install /absolute/path/to/plugin-examples/lifecycle-logger
paseo plugin logs lifecycle-logger

The same entries appear in the target daemon's daemon.log. The plugin log viewer retains a bounded tail; use the daemon log for longer captures. Log lines are capped at 16 KiB, so a large timeline can be truncated.

See the lifecycle reference for callback shapes and delivery rules. The real-provider test in packages/server/src/server/plugins/lifecycle.real.e2e.test.ts runs both examples on an isolated daemon and saves evidence under .dev/lifecycle-proof/.

Run it from packages/server on Linux with Claude configured:

npx vitest run src/server/plugins/lifecycle.real.e2e.test.ts --bail=1

The test uses real provider calls and a temporary daemon home. Its failure check uses Linux /proc to identify and terminate only its own Claude subprocess. The credits check asks the real agent to emit the matching phrase; it does not exhaust an account's credits.