v0.3.0 — Generic agent reporting and improved setup doctor
sway-session v0.3.0
Highlights
- Doctor now understands ordinary Sway output/input/bar and literal mode blocks, continued lines and safe includes. Daemon startup, restore startup and both default terminal shortcuts have separate evidence.
- Partial checks retain known declarations and actionable limitation locations. Unknown configuration does not become a missing requirement or enable unsafe repair.
- Doctor's compact TUI pages through the actual detail viewport, so PgUp/PgDown no longer skip evidence. Additional limitations are explicitly counted when the bounded display limit is reached.
- Agent-session reporting uses the generic owner-only
agent-report.sockendpoint. Provider event translation lives in the supplied hook adapter, not a provider-specific daemon.
Breaking change: legacy Codex reporting removed
report-codex-session, codex-report.sock and the report protocol-v1 adapter have been removed. Generic agent reporting protocol v2 and session-start protocol v1 are unchanged. Stored state, configuration paths and database schema need no migration.
If you use the Codex SessionStart hook:
- Replace only its old sway-session command using the packaged example at
/usr/share/doc/sway-session/contrib/codex/hooks.json; preserve unrelated hooks. The new command is/usr/lib/sway-session/codex-report-agent-session /usr/bin/sway-session. - Ensure
jqis available for this optional hook adapter. The daemon and generic reporting command do not need it. - If using AppArmor, review and load the updated policy with
agent-report.sockaccess. - Restart the sway-session daemon, then restart or resume relevant Codex agents so their new SessionStart hook runs. Existing agents do not emit that event retroactively.
Full upgrade guidance: Agent-session reporting.
The experimental AppArmor socket and unconfined-pane limitations remain; this release does not claim to close them. Doctor inspects static configuration declarations, not an effective live keybinding inventory.
Packaging
Linux amd64/arm64 archives, DEBs and RPMs; AUR source package sway-session. Sway remains the sole runtime package dependency, and Go is build-only for source packages. No optional dependency metadata was added.