@odradekk/vera-ui
v0.2.0
Published
Session UI extensions for Vera agent (banner, status line, thinking cycle)
Readme
vera-ui
Purpose
Provide interactive session presentation for Pi: startup banner, status line, thinking shortcut cycling, and /thinking command behavior.
Non-goals
- web/search/data retrieval tools
- compaction or prompt-rule assembly
- provider compatibility patches
- generic shared infrastructure for other packages
Registered surface
Commands
/thinking— cycle or set thinking level directly
Shortcuts
- configurable thinking-cycle shortcut from
session-ui.json
Hooks / UI integration
session_start— loads config, registers shortcut, installs banner/footer when UI existsturn_start/turn_end— refreshes footer renderingmodel_select— syncs current model and refreshes footer
Config
Reads, in order of precedence:
- project
.pi/config/session-ui.json agent/config/session-ui.json- legacy project
.pi/thinking.json - legacy
agent/thinking.json
External dependencies
- terminal UI must be available for banner/footer rendering
- no external API keys required
Smoke
npm run smoke- from project root:
node agent/scripts/smoke-all.mjs
Debugging
- Run
node packages/vera-ui/scripts/smoke.mjsto verify command registration and project-configured shortcuts. - If
/thinkingbehaves oddly, inspect the active model id and the resolved profile insession-ui.json. - If UI output is missing, confirm
ctx.hasUIis true; non-UI modes intentionally degrade to command-only behavior.
Loaded through agent/settings.json as ./packages/vera-ui.
