feat: a2ui interface to enablee the LLM to give structured information

README.md

@@ -39,6 +39,38 @@ Projects, sessions, and transcripts use SQLite. Settings use a compact YAML file
 that contains only values changed from their defaults and can also be edited by
 hand.
 
+## A2UI widgets
+
+DS4Server renders A2UI v1.0 surfaces with these widgets:
+
+- **Content:** Markdown text, images (including avatars), icons, video and audio
+  players, and dividers.
+- **Layout:** rows, columns, lists, cards, modals, and tabs.
+- **Controls:** buttons, text fields, checkboxes, sliders, date/time inputs, and
+  choice pickers.
+- **Research:** bar, line, area, stacked-bar, pie, and donut charts; tables,
+  metrics, timelines, maps, mind maps, and forms.
+
+Video posters render in the surface; video and audio playback uses native
+macOS AVKit player windows with standard transport, volume, and fullscreen
+controls.
+
+### Live A2UI validation
+
+With DS4Server running and its local endpoint enabled, run the opt-in model
+validation suite with:
+
+```sh
+cargo run --release -- validate-a2ui
+```
+
+It sends natural-language chart, form, choice, and full-composition prompts
+through the current A2UI tool description, then replays every returned protocol
+message through the real catalog and component-graph validators. Use `--case
+pie-natural`, `--case composed-basics`, `--attempts 3`, `--model MODEL_ID`, or
+`--endpoint URL` to narrow or repeat runs. This slow, model-dependent suite is
+intentionally separate from `cargo test`.
+
 ## Build and run
 
 DS4Server targets macOS 13 or newer and requires Rust 1.97 plus
@@ -53,9 +85,9 @@ open target/release/DS4Server.app
 ## Application data
 
 ```text
-~/Library/Application Support/DS4Server.rfc1437.de/data.sqlite3
-~/Library/Application Support/DS4Server.rfc1437.de/config.yaml
-~/Library/Application Support/DS4Server.rfc1437.de/kv-cache/
+~/Library/Application Support/de.rfc1437.ds4server/data.sqlite3
+~/Library/Application Support/de.rfc1437.ds4server/config.yaml
+~/Library/Application Support/de.rfc1437.ds4server/kv-cache/
 ```
 
 Deleting a project or session removes DS4Server metadata and its associated