Add short_description field for agents and agent details dialog

[dibenkobit]

Closes #4825

Summary

Previously, when you created an agent via opencode agent create, the description field was populated with a long prompt intended for the model. In /agents, this made the list view almost unreadable.

This PR introduces three changes:

1. short_description field

   • New field used for displaying agents in /agents.
   • If short_description is not set, the UI falls back to a truncated version of description.

2. Agent details dialog (Ctrl+E)

   • You can now open a scrollable details dialog for custom agents.
   • The dialog shows the whenToUse (description) text, so the list can stay compact while the full content is still accessible when needed.

3. Dynamic description truncation

   • Descriptions in /agents are now truncated based on the current terminal width, so they fit neatly into the dialog without overflowing.

Why this approach

• short_description gives us a dedicated, human‑readable summary for the UI instead of trying to reuse the full whenToUse text.
• The details dialog preserves the ability to inspect the full prompt when needed without cluttering the main list.
• Truncation based on terminal width keeps /agents readable across different environments and terminal sizes.

Focus bug fix

While implementing the details dialog, a focus bug surfaced: switching between dialogs (e.g., /agents ↔ agent details) caused the main input to lose focus.

Root cause:

• There was a race between keyboard handlers when dialogs were opened/closed in quick succession.
• replace() could overwrite an existing valid saved focus reference.
• refocus() was being called even when a new dialog was about to open immediately after.

Fix:

• Prevent replace() from clobbering a valid saved focus reference.
• Skip refocus() when a new dialog is opened right after closing the previous one.

How to test

• Have an agent that was created before the update (to verify backward compatibility).

• Create a new agent with short_description set.

• Open /agents.

• Confirm both agents show a visible description:

  • New agent shows short_description.
  • Old agent shows a truncated description.

• Verify that text is truncated correctly according to the dialog/terminal width.

• Focus a native agent and verify the footer is not shown.

• Focus a custom agent and check that the Ctrl+E hotkey is shown in the footer.

• Press Ctrl+E on a custom agent and confirm the agent details dialog opens.

• In the details dialog, verify that the scrollbar works with both keyboard and mouse.

• Close the details dialog and confirm the /agents dialog reappears with the same selection preserved.

• Open other dialogs (e.g., /models, /sessions) and confirm their behavior and focus handling are unchanged.

Demo

[dibenkobit]

I'm also thinking about showing systemPrompt instead of whenToUse (aka description) in details dialog... 🤔 it may be more useful

[dibenkobit]

my bad, ran the format script

[dibenkobit]

my bad, ran the format script

Hm, when running local prettier also adds EOL to 2 package.json's, even though ain't touched them. Didn't commit them. Hope won't be a problem.

[rekram1-node]

Yeah idk why it does that new line shit it's so annoying disregard it haha

[github-actions]

Closing this pull request because it has had no updates for more than 60 days. If you plan to continue working on it, feel free to reopen or open a new PR.