Skip to content

v0.3.0 — Generic agent reporting and improved setup doctor

Choose a tag to compare

@github-actions github-actions released this 05 Sep 19:22
· 8 commits to main since this release
ffc4b0b

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.sock endpoint. 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:

  1. 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.
  2. Ensure jq is available for this optional hook adapter. The daemon and generic reporting command do not need it.
  3. If using AppArmor, review and load the updated policy with agent-report.sock access.
  4. 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.

Includes LAB-125 (#11) and LAB-126 (#12).